Getnote Kb
List, create, and curate Get笔记 knowledge bases from the terminal so your agent can pull or file research without leaving the CLI.
Overview
getnote-kb is an agent skill most often used in Build (also Idea/research) that manages Get笔记 knowledge bases via the getnote CLI.
Install
npx skills add https://github.com/iswalle/getnote-cli --skill getnote-kbWhat is this skill?
- Covers getnote kbs, kbs-sub with pagination, kb browse with --limit and --all
- kb create with name and optional --desc for new knowledge bases
- JSON output via -o json for agent parsing of topic_id, note_count, and note lists
- Documents subscribed KBs, blogger content, live sessions, and quota surfaces in the full skill
- Default 20 notes per page on getnote kb browse
Adoption & trust: 607 installs on skills.sh; 127 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your agent needs read/write access to Get笔记 knowledge bases but only knows generic shell—not the getnote kb command surface.
Who is it for?
Indie builders already on Get笔记 who want terminal-driven KB ops inside agent sessions.
Skip if: Users without Get笔记 accounts, teams that forbid third-party note SaaS, or workflows that need full-text search logic not exposed in these CLI commands.
When should I use this skill?
Managing knowledge bases in Get笔记 via the getnote CLI (list, subscribe, browse, create).
What do I get? / Deliverables
The agent runs documented getnote commands to list, subscribe, browse, create KBs, and return JSON the rest of your workflow can consume.
- KB listings with topic_id metadata
- Paginated or full note exports
- New knowledge base created via CLI
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Build/integrations is canonical because the skill is entirely about wiring the getnote CLI commands into agent workflows. Integrations fits external Get笔记 KB APIs exposed through getnote kbs, kb, kbs-sub, and kb create—not app frontend code.
Where it fits
Create a new KB with getnote kb create before piping captured URLs into notes.
Run getnote kb <topic_id> --all to ingest competitor research into a validate brief.
Use getnote kbs -o json so the agent picks the right topic_id for a RAG prep step.
How it compares
CLI command reference for one product—not a generic PKM framework or local Obsidian skill.
Common Questions / FAQ
Who is getnote-kb for?
Solo builders using Get笔记 who want Claude/Codex/Cursor to list, browse, and create knowledge bases via getnote.
When should I use getnote-kb?
During Build/integrations when automating KB maintenance; during Idea/research when pulling subscribed or owned notes into a build or validate doc.
Is getnote-kb safe to install?
It assumes an authenticated CLI that talks to Get笔记 services—review the Security Audits panel on this page and treat topic IDs and note content as sensitive.
SKILL.md
READMESKILL.md - Getnote Kb
# getnote-kb Skill Manage knowledge bases — list, create, browse notes, add/remove notes. Also supports subscribed knowledge bases, blogger content, live sessions, and quota. ## Prerequisites - `getnote` CLI installed and authenticated (`getnote auth status` should show "Authenticated") ## Commands ### List all knowledge bases ``` getnote kbs ``` Returns all knowledge bases. Each item includes: `topic_id`, `name`, `description`, `note_count`, `created_at`. ```bash getnote kbs getnote kbs -o json ``` --- ### List subscribed knowledge bases ``` getnote kbs-sub [--page <n>] ``` Returns knowledge bases the user has subscribed to. Supports pagination. | Flag | Default | Description | |------|---------|-------------| | `--page` | 1 | Page number | ```bash getnote kbs-sub getnote kbs-sub --page 2 getnote kbs-sub -o json ``` > Use `getnote kb <topic_id>` to browse notes inside a subscribed knowledge base. --- ### List notes in a knowledge base ``` getnote kb <topic_id> [--limit <n>] [--all] ``` Returns 20 notes per page by default. | Flag | Default | Description | |------|---------|-------------| | `--limit` | 20 | Notes per page | | `--all` | — | Fetch all notes (auto-paginate) | ```bash getnote kb vnrOAaGY getnote kb vnrOAaGY --all getnote kb vnrOAaGY -o json ``` --- ### Create a knowledge base ``` getnote kb create <name> [--desc <description>] ``` ```bash getnote kb create "Research Papers" getnote kb create "Project Docs" --desc "Documentation links" ``` > Max 50 knowledge bases per day (resets at 00:00 Beijing time). --- ### Add notes to a knowledge base ``` getnote kb add <topic_id> <note_id> [note_id...] ``` Supports multiple note IDs. Max 20 per call. ```bash getnote kb add vnrOAaGY 1234567890 getnote kb add vnrOAaGY 1234567890 9876543210 ``` > Already-existing notes are silently skipped. --- ### Remove notes from a knowledge base ``` getnote kb remove <topic_id> <note_id> [note_id...] ``` ```bash getnote kb remove vnrOAaGY 1234567890 ``` > ⚠️ **订阅知识库限制**：如果目标知识库是他人创建（通过 `getnote kbs-sub` 获取），且用户不是该知识库的管理员，则无法添加或移除笔记，API 会返回错误。只有自己创建的知识库（`getnote kbs`）才支持完整的增删操作。 --- ### List bloggers in a knowledge base ``` getnote kb bloggers <topic_id> [--page <n>] ``` Returns subscribed bloggers. Each item includes: `follow_id` (required for content queries), `account_name`, `platform`, `follow_time`. ```bash getnote kb bloggers vnrOAaGY getnote kb bloggers vnrOAaGY --page 2 -o json ``` --- ### List blogger contents ``` getnote kb blogger-contents <topic_id> <follow_id> [--page <n>] ``` Returns content list (no full text). Use `post_id_alias` to fetch detail. ```bash getnote kb blogger-contents vnrOAaGY follow123 getnote kb blogger-contents vnrOAaGY follow123 --page 2 ``` --- ### Show blogger content detail ``` getnote kb blogger-content <topic_id> <post_id> ``` Returns full content including original text (`post_media_text`). ```bash getnote kb blogger-content vnrOAaGY post_abc123 getnote kb blogger-content vnrOAaGY post_abc123 -o json ``` --- ### List completed lives in a knowledge base ``` getnote kb lives <topic_id> [--page <n>] ``` Returns only completed live sessions that have been AI-processed. ```bash getnote kb lives vnrOAaGY getnote kb lives vnrOAaGY --page 2 ``` --- ### Show live detail ``` getnote kb live <topic_id> <live_id> ``` Returns AI summary (`post_summary`) and full transcript (`post_media_text`). ```bash getnote kb live vnrOAaGY live_abc123 getnote kb live vnrOAaGY live_abc123 -o json ``` --- ### Follow a live channel in a knowledge base ``` getnote kb live-follow <topic_id> <link> [--platform <platform>] ``` Subscribes a Dedao live channel to a knowledge base. Once the live session ends and is AI-processed, it will appear in `kb lives`. > ⚠️ Currently only Dedao App live links are supported. ```bash getnote kb live-follow vnrOAaGY https://m.dedao