Karakeep
Karakeep saves links and notes to read later. This shows what you saved and a pile to read, and lets the assistant search, summarize and save.
Set it up
Section titled “Set it up”integrations: karakeep: type: karakeep url: http://karakeep:3000 apiKey: ${KARAKEEP_APIKEY} href: https://saved.example.com
layout: - title: Apps widgets: - karakeep.digest| Option | Type | Default | What it does |
|---|---|---|---|
url | URL | required | Where the service answers, from Valet’s side. |
apiKey | string | required | Its API key. Use ${VAR}. |
href | string | optional | Where the card links to, when that differs from url. |
Widgets
Section titled “Widgets”3 widgets. Each key starts with your instance name, here karakeep.
Recently saved
Section titled “Recently saved”karakeep.digest · list card · refreshes every 5 minutes while the page is open.
Small draws the same as medium. Wide draws the same as medium. Tall draws the same as medium, so they aren't shown. Only the empty space changes.
States
Section titled “States”
From your reading
Section titled “From your reading”karakeep.reading · article card · refreshes every hour while the page is open.
Small draws the same as medium. Wide draws the same as medium, so they aren't shown. Only the empty space changes.
States
Section titled “States”
karakeep.recent · shelf card · refreshes every 2 minutes while the page is open.
Small draws the same as medium. Wide draws the same as medium. Tall draws the same as medium, so they aren't shown. Only the empty space changes.
States
Section titled “States”
Assistant tools
Section titled “Assistant tools”What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.
| Tool | Access | What it does |
|---|---|---|
bookmarks_search | read | Search the person’s saved links and notes in Karakeep (titles, page text, AI summaries, tags). |
bookmark_summarize | write | Have Karakeep write its AI summary of a saved link or note, by id (bookmarks_search finds the id). |
bookmark_read | read | Read one saved bookmark by id: its summary, note, tags and link. |
bookmark_save | write | Save a link (or a text note) to Karakeep. |
Actions
Section titled “Actions”What the page’s own buttons and controls can do. They need a signed-in person or a trusted network.
| Action | What it does |
|---|---|
archive | Archive a saved link |
unarchive | Bring an archived link back |
Year in review
Section titled “Year in review”Slides this integration adds to the recap.
