getnote-search Skill
Semantic search across all notes or within a specific knowledge base.
Prerequisites
getnoteCLI installed and authenticated (getnote auth statusshould show "Authenticated")
Commands
Search notes
getnote search <query> [--kb <topic_id>] [--limit <n>]| Flag | Default | Description |
|---|---|---|
--kb | — | Limit search to a knowledge base (topic_id) |
--limit | 10 | Max results (max 10) |
Results are ranked by semantic relevance (high → low). Each result includes: note_id, title, content (excerpt), score, created_at, note_type.
Note:
note_idis only populated forNOTEtype results. Other types (FILE,BLOGGER,LIVE, etc.) return an emptynote_id.
# Search across all notes
getnote search "大模型 API"
# Search within a knowledge base
getnote search "RAG" --kb qnNX75j0
# Limit results + JSON output
getnote search "机器学习" --limit 5 -o json---
Agent Usage Notes
- Use
-o jsonwhen parsing results programmatically. - JSON response:
{"success":true,"results":[{"note_id":"...","title":"...","content":"...","score":0.95,"created_at":"...","note_type":"..."}]} - Note:
resultsis at the top level, not nested underdata. - Get
topic_idfor--kbfromgetnote kbs -o json→data.topics[].topic_id. - For
NOTEtype results, usegetnote note <note_id>to get the full content. - Max
--limitis 10; usegetnote notesfor browsing without a query. - Exit code
0= success; non-zero = error. Error details go to stderr.
