karakeep

// Manage bookmarks and links in a Karakeep instance. Use when the user wants to save links, list recent bookmarks, or search their collection. Triggers on phrases like "hoard this link", "save to karakeep", or "search my bookmarks".

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namekarakeep

descriptionManage bookmarks and links in a Karakeep instance. Use when the user wants to save links, list recent bookmarks, or search their collection. Triggers on phrases like "hoard this link", "save to karakeep", or "search my bookmarks".

metadata[object Object]

Karakeep Skill

Save and search bookmarks in a Karakeep instance.

Setup

First, configure your instance URL and API key:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py login --url <instance_url> <api_key>

Commands

Save a Link

Add a URL to your collection:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py add <url>

List Bookmarks

Show the most recent bookmarks:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py list --limit 10

Search Bookmarks

Find bookmarks matching a query. Supports complex syntax like is:fav, title:word, #tag, after:YYYY-MM-DD, etc.:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py list --search "title:react is:fav"

Troubleshooting

Ensure KARAKEEP_API_KEY (or HOARDER_API_KEY) is set or run login.
Verify the instance URL is correct in the script or config (~/.config/karakeep/config.json).