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".

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).