Official skill for how to use karakeep (the bookmark manager) and interact with it programmatically.
Karakeep is an open source self-hosted bookmark manager for collecting, organizing, and searching content. This skill covers the core concepts and how to interact with Karakeep via the CLI.
Use this skill when the user wants to interact with their Karakeep instance (adding bookmarks, managing lists/tags, searching, etc.).
#ai -archived).Lightweight labels for any bookmark (topics, sources, workflow states). Multiple tags per bookmark, tags travel with bookmarks across lists. AI can auto-generate tags when configured.
Karakeep has a powerful search query language for finding the right bookmarks. It supports full-text search, boolean logic, qualifiers, and more.
and / or keywords for explicit boolean logic.- or ! to negate it (e.g., -is:archived, !is:fav).() for grouping (note: groups themselves can't be negated).machine learning is:fav).| Qualifier | Description | Example |
|---|---|---|
is:fav | Favorited bookmarks | is:fav |
is:archived | Archived bookmarks | -is:archived |
is:tagged | Bookmarks with one or more tags | is:tagged |
is:inlist | Bookmarks in one or more lists | is:inlist |
is:link | Link bookmarks | is:link |
is:text | Text/note bookmarks | is:text |
is:media | Media bookmarks (images/PDFs) | is:media |
is:broken | Bookmarks with failed crawls or non-2xx status codes | is:broken |
url:<value> | Match URL substring | url:github.com |
title:<value> | Match title substring (supports quoted strings) | title:rust, title:"my title" |
#<tag> or tag:<tag> | Match bookmarks with specific tag (supports quoted strings) | #important, tag:"work in progress" |
list:<name> | Match bookmarks in a specific list (supports quoted strings) | list:reading, list:"to review" |
after:<date> | Created on or after date (YYYY-MM-DD) | after:2024-01-01 |
before:<date> | Created on or before date (YYYY-MM-DD) | before:2024-12-31 |
age:<time-range> | Filter by creation age. Use < / > for max/min age. Units: d (days), w (weeks), m (months), y (years) | age:<1d, age:>2w, age:<6m |
feed:<name> | Bookmarks imported from a specific RSS feed | feed:Hackernews |
source:<value> | Match by capture source. Values: api, web, cli, mobile, extension, singlefile, rss, import | source:rss, -source:web |
# Favorited bookmarks from 2024 tagged "important"