otty / apps
All apps/Karakeep CLI

Karakeep CLI

karakeep

CLI tool for the self-hostable bookmark-everything app.

Runs as karakeep|macOS, Linux, Windows|karakeep.app
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 17 fields

Add, list and search bookmarks. The server address and API key come from the config file or environment (KARAKEEP_SERVER_ADDR, KARAKEEP_API_KEY), not from this form; update, delete, lists and tags are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui karakeep

karakeep bookmarks add

Add bookmarks

Create bookmarks from links, notes or files.

Add bookmarksExample values, fixed in this page — nothing here reaches a terminal
Basic
Link*
url
Title
string
Advanced
List ID
string
Tag
string
TasksEach one presets the form for one job
Add a link
linktitletag_namelist_id
ParametersOnly these flags are editable in the form
Link
url · repeatable
--link
Note text
string · repeatable
--note
Asset file (image or PDF)
path · repeatable
--asset
List ID
string
--list-id
Tag
string · repeatable
--tag-name
Title
string
--title

karakeep bookmarks search

Search bookmarks

Search with matchers such as tag:name or is:fav.

Search bookmarksExample values, fixed in this page — nothing here reaches a terminal
Basic
Query*
string
Results per page
integer
Sort order
3 choicesenum
Search mode
3 choicesenum
TasksEach one presets the form for one job
Search
querylimitsort_ordersearch_mode
ParametersOnly these flags are editable in the form
Query
string · positional 0
Results per page
integer
--limit
Sort order
enum
--sort-orderrelevanceascdesc
Search mode
enum
--search-modeftssemantichybrid
Include full content
boolean
--include-content
Fetch all pages
boolean
--all

karakeep bookmarks list

List bookmarks

List bookmarks, optionally for one list or tag.

List bookmarksExample values, fixed in this page — nothing here reaches a terminal
Basic
Include archived
--include-archived
Only this list ID
string
Only this tag ID
string
Bookmarks per page
integer
Fetch all pages
--all
TasksEach one presets the form for one job
List bookmarks
include_archivedlist_idtag_idlimitall
ParametersOnly these flags are editable in the form
Include archived
boolean
--include-archived
Only this list ID
string
--list-id
Only this tag ID
string
--tag-id
Bookmarks per page
integer
--limit
Fetch all pages
boolean
--all
SourcesEvery flag above is checked against these
src
.command("add") "--link <link>", "the link to add. Specify multiple times to add multiple links", "--note <note>", "--asset <file>", "the file path of an asset (image or pdf) to add. Specify multiple times to add multiple assets", "--list-id <id>", "--tag-name <tag>", "--title <title>",
helpmain 2026-10-27

github.com

src
.command("search") "<query>", "the search query (supports matchers like tag:name, is:fav, etc.)", "--limit <limit>", "--sort-order <order>", "sort order for results", if (val !== "relevance" && val !== "asc" && val !== "desc") { "--search-mode <mode>", if (val !== "fts" && val !== "semantic" && val !== "hybrid") { "--include-content", .option("--all", "fetch…
helpmain 2026-10-27

github.com

src
.command("list") "--include-archived", "--list-id <id>", "if set, only items from that list will be fetched" "--tag-id <id>", "if set, only items with that tag will be fetched" "--include-content", "--limit <limit>", .option("--all", "fetch all bookmarks (paginate through all pages)", false)
helpmain 2026-10-27

github.com

Before it fills your prompt, Otty checks the installed karakeep against its version. A form that does not match your version is not offered.