docs/cli

cli

The keep CLI lets you list, search, and retrieve your saved bookmarks from the terminal. Useful for piping markdown content into scripts, agents, or other tools.

install

npm i -g keep-markdown

setup

Sign up at keep.md, create a personal API key on the dashboard, then save it:

keep key YOUR_API_KEY

Your key is stored in ~/.config/keep/config.json. You can also pass it inline with --key or set the KEEP_API_KEY environment variable.

keep list

List your saved items. Archived items are excluded by default.

keep list
a1b2c3  https://example.com/article  Example Article
d4e5f6  https://blog.dev/post       Some Blog Post

Filter by time, status, or search query:

keep list --since 7d --status stashed,flagged --limit 20

Add --content to include the extracted markdown in the output. Add --json for raw JSON.

keep search

Search your bookmarks by title, URL, notes, or tags.

keep search "react hooks"

keep get

Get full metadata for a single item.

keep get a1b2c3

Add --content to include the extracted markdown.

keep content

Print the extracted markdown for an item. Useful for piping into other tools.

keep content a1b2c3
# Example Article

The full extracted markdown content of the page...

keep archive

Archive an item to hide it from your default list.

keep archive a1b2c3

keep me

Display your account info — plan, limits, and usage.

keep me

keep stats

Usage statistics for a date range.

keep stats --since 30d

keep feed

List unprocessed items with their full content. Designed for AI agents that consume your bookmarks as context.

keep feed --limit 10

keep processed

Mark one or more items as processed so they leave the feed.

keep processed a1b2c3 d4e5f6

global options

These flags work with any command:

--json — output raw JSON instead of formatted text

--key <token> — use a specific API key for this request

--base <url> — override the API base URL