keep-markdown

CLI for keep.md — search and retrieve saved web content as Markdown.

Setup

1. Sign up for an account at https://keep.md
2. Create an API token at https://keep.md/dashboard
3. Save your token:

npm i -g keep-markdown
keep key <your-token>

Alternatively set the KEEP_API_KEY environment variable.

Usage

keep list --since 7d
keep list --tag agent-tooling --collection x-articles
keep search "react hooks"
keep search "agents" --tag agent-tooling --collection x-articles
keep save https://example.com/article
keep update <id> --processed
keep update <id> --collection x-articles
keep update <id> --collections x-articles,reading-list
keep tags list
keep collections list
keep collections add "X Articles"
keep sync ./items.json
keep feed --since 7d
keep feed --tag agent-tooling
keep processed <id1> <id2>
keep get <id>
keep highlights <item-id>
keep highlight <highlight-id>
keep content <id>
keep whoami
keep sources list
keep sources add rss https://example.com/feed.xml
keep stats

Default text output for list, search, and feed is: <id>\t<url>\t<title>

Use --json for structured output. Add --content --json on list or search to include both the structured content object and the rendered contentMarkdown. keep get <id> returns the full item JSON, including saved highlights and summaryMarkdown when an AI summary has been generated (paid plans).

keep highlights <item-id> lists highlights attached to an item. Default text output is <highlightId>\t<itemId>\t<text>. Use --json for the full response. keep highlight <highlight-id> returns one highlight as JSON.

keep content <id> returns the item's markdown with a ## Summary section at the top when a summary is available, followed by the full article body.

Tag and collection filters accept slugs or names. Slugs use lowercase words joined by hyphens, like x-articles or agent-tooling.

Tags and collections

keep tags list
keep collections list
keep collections add "X Articles"
keep list --tag agent-tooling
keep search "agents" --collection x-articles
keep update <id> --collection x-articles
keep update <id> --collections x-articles,reading-list
keep update <id> --clear-collections

Save and sync

Save one URL with server-side extraction:

keep save https://example.com/article

Bulk sync items from a JSON file:

keep sync ./items.json

The sync file can be either an array of items or an object with an items array.

Sources

keep sources list
keep sources add rss https://example.com/feed.xml
keep sources add youtube @fireship_dev
keep sources add x levelsio
keep sources add email
keep sources remove <id>

Run keep help for the full list of commands and options.