Getnote Search
- 1k installs
- 165 repo stars
- Updated July 27, 2026
- iswalle/getnote-cli
getnote-search is a getnote CLI agent skill that runs semantic search across Get笔记 notes and knowledge bases for developers who need ranked note retrieval inside Claude, Cursor, or other agent workflows.
About
getnote-search version 0.4.0 wraps the getnote CLI search command for agent-driven semantic retrieval across personal notes. After authenticating with getnote auth status, agents run getnote search <query> with optional --kb <topic_id> to scope a knowledge base and --limit <n> capped at 10 results ranked by relevance score. JSON output via -o json returns note_id, title, content excerpt, score, created_at, and note_type; agents fetch full NOTE content with getnote note <note_id> and discover topic_id values via getnote kbs -o json. Developers reach for getnote-search when an agent needs context from prior notes during coding, debugging, or research without manually opening the Get笔记 app.
- Semantic search across all notes or a specific knowledge base
- Returns ranked results with note_id, title, content excerpt, relevance score and metadata
- Supports --kb, --limit and -o json flags for precise agent parsing
- JSON output optimized for programmatic consumption by coding agents
- Works with Get笔记 (GetNote) CLI for RAG-style note retrieval
Getnote Search by the numbers
- 1,011 all-time installs (skills.sh)
- +31 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #477 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/iswalle/getnote-cli --skill getnote-searchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1k |
|---|---|
| repo stars | ★ 165 |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 27, 2026 |
| Repository | iswalle/getnote-cli ↗ |
How do you search personal notes from an agent?
Run semantic search across personal notes and knowledge bases directly from Claude, Cursor or any agent workflow.
Who is it for?
Developers using Get笔记 with the authenticated getnote CLI who want agents to pull note context during coding workflows.
Skip if: Teams without Get笔记 accounts or developers who need codebase grep rather than personal note semantic search.
When should I use this skill?
The user asks to search Get笔记 notes, retrieve knowledge base context, or find prior research stored in getnote.
What you get
Ranked search results with note_id, title, content excerpt, score, and optional full note retrieval via getnote note.
- Ranked search results
- JSON note metadata
- Full note content via follow-up command
By the numbers
- Version 0.4.0 with default and maximum --limit of 10 results
- JSON results include note_id, title, content, score, created_at, note_type
Files
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.
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493kHow it compares
Use getnote-search for personal Get笔记 notes; use codebase search tools when the target is repository source files.
FAQ
What command does getnote-search use?
getnote-search runs getnote search <query> with optional --kb <topic_id> and --limit <n> where the maximum limit is 10. Use -o json for programmatic parsing by agents.
What prerequisites does getnote-search require?
getnote-search requires the getnote CLI installed and authenticated—getnote auth status must show Authenticated before search commands return ranked semantic results.
How do agents fetch full note content after search?
getnote-search returns note_id for NOTE-type results; agents then run getnote note <note_id> for full content. Other note types like FILE or BLOGGER may return empty note_id.
Is Getnote Search safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.