Keep searches both Notes and saved Items. It combines exact text matches with meaning-based matches.
Use global search
Global search is the fastest way to find context or open part of the app.
- Press
Command Kon macOS orControl Kon Windows and Linux. - Enter words from the Note, Item, or topic.
- Select a result.
Results can include Notes, Items, recent Notes, pages, and actions. Note results can show the Project and the latest contributor. Item results can show the source, tags, and saved date.
Keep checks titles, URLs, Note bodies, Item notes, tags, and saved content. It can find a relevant result even when your search does not contain the exact words in that result.
Long searches are split into useful terms. A distinctive title stays ahead of weaker matches, and cue lists in session summaries help Keep recover a Note from the names or concepts you still remember.
Filter global search
Start a search with one of these filters. Select a suggested value, then enter the rest of your search.
| Filter | Finds |
|---|---|
source: |
Items from one source or website |
tag: or # |
Notes and Items with one tag |
collection: or in: |
Items in one collection |
project: |
Notes in one Project |
kind: |
Notes with one kind |
state: |
Notes with one state |
Use quotation marks around a value that contains spaces.
project:"Keep website" session hooks
tag:research agent memory
kind:handoff state:open
source:youtube transcripts
in:"AI research" evaluationFilter the Feed
The search field in the Feed searches Items only. Press / to
focus it.
The Feed supports free text and these filters:
source:for a source or websitetag:or#for a tagcollection:orin:for a collection
You can combine filters with text.
authentication tag:security in:research
source:github agent toolsThe Feed keeps the search and filters in the URL. You can open an Item and move to the previous or next matching Item without losing the search.
Search from the CLI
keep search is the main CLI search command. It searches Notes and Items. In a
Git repository, it also uses the repository and current path to rank relevant
project context.
keep search "OAuth handoff"
keep notes search "OAuth handoff"
keep items search "OAuth handoff"Use keep notes search or keep items search when you need one resource type.
Note search returns bounded results and accepts the same --project, --path,
--exact-project, and --exact-path filters as the main search command.
keep context remains a compatibility alias for keep search.
See the CLI guide for output and filtering options.
Search with the API
Use GET /api/search to search Notes and Items together.
curl "https://keep.md/api/search?q=session%20handoff&types=note,item&mode=hybrid" \
-H "Authorization: Bearer $KEEP_API_KEY"Use GET /api/notes/search for Notes only. Use GET /api/items/search for
Items only. Search mode can be lexical, semantic, or hybrid.
See the API reference for all parameters.