getnote-search

iswalle/getnote-cli

Source View on skills.sh

How to install getnote-search

npx skills add https://github.com/iswalle/getnote-cli --skill getnote-search

Claude Code

Cursor

Windsurf

Cline

Full instructions (SKILL.md)

Source of truth, from iswalle/getnote-cli.

name: getnote-search version: 0.4.0 description: Semantic search across notes in Get笔记 via the getnote CLI

getnote-search Skill

Semantic search across all notes or within a specific knowledge base.

Prerequisites

getnote CLI installed and authenticated (getnote auth status should 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_id is only populated for NOTE type results. Other types (FILE, BLOGGER, LIVE, etc.) return an empty note_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 json when parsing results programmatically.
JSON response: {"success":true,"results":[{"note_id":"...","title":"...","content":"...","score":0.95,"created_at":"...","note_type":"..."}]}
Note: results is at the top level, not nested under data.
Get topic_id for --kb from getnote kbs -o json → data.topics[].topic_id.
For NOTE type results, use getnote note <note_id> to get the full content.
Max --limit is 10; use getnote notes for browsing without a query.
Exit code 0 = success; non-zero = error. Error details go to stderr.