Keep searches both notes and saved Markdown. It combines exact text matches with meaning-based matches, so a vague memory can still find the right item.
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. Results for notes can show the Project and the latest contributor. Results for items 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 Saved
The search field in Saved searches items only. Press / to
focus it.
Saved 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 toolsSaved 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
across your library. Project and path filters remain available for advanced
workflows, but this command does not detect them automatically.
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.
Search results for notes are bounded and accept the same --project, --path,
--exact-project, and --exact-path filters as the main search command.
keep context is a separate compatibility command for advanced Git project
workflows. It detects the current project and path before it searches.
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.