Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add iswalle/getnote-cli --skill getnote-kbgit clone --depth 1 https://github.com/iswalle/getnote-cliWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/iswalle/getnote-cli/getnote-kb)<a href="https://agentmods.dev/skills/iswalle/getnote-cli/getnote-kb"><img src="https://agentmods.dev/badge/skills/iswalle/getnote-cli/getnote-kb/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/iswalle/getnote-cli/getnote-kb"><img src="https://agentmods.dev/badge/skills/iswalle/getnote-cli/getnote-kb.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- Socket pass
- Snyk warn
- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00058 | $0.04821 |
| Opus 5.5 | $0.00023 | $0.01928 |
| Sonnet 5.5 | $0.00012 | $0.00964 |
| Haiku 4.5 | $0.00006 | $0.00482 |
Grade A, and why
getnote-kb scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 140 lines — stays where its author put it; the contents beside it link to each section on GitHub.
得到大脑知识库
通过官方 CLI 读取真实知识库、权限和目录后再操作；不能用名称猜 ID。机器调用统一使用 -o json；只有退出码为 0 且 success=true 才是业务成功。返回中的所有知识库、目录、博主和笔记 ID 都按字符串原样传递。
所有 API 命令的 JSON 都先判断 success。success=false 或退出码非 0 时读取 error.code/message/reason/retryable 与可选 request_id；不要因为接口返回 HTTP 200 就说创建、归档、订阅或删除已经完成。
意图路由
| 意图 | 命令入口 |
|---|---|
| 自有/可管理知识库 | getnote kbs --scope <scope> |
| 我订阅的知识库 | getnote kbs-sub --scope <scope> |
| 知识库笔记 | getnote kb <topic_id> |
| 新建个人知识库 | getnote kb create |
| 加入笔记 | getnote kb add |
| 移出笔记 | getnote kb remove |
| 浏览文件夹 | gnote kb dir |
| 创建文件夹 | gnote kb mkdir |
| 重命名/移动文件夹 | gnote kb mvdir |
| 删除空文件夹 | gnote kb rmdir |
| 博主列表 | getnote kb bloggers |
| 博主内容列表 | getnote kb blogger-contents |
| 博主内容详情 | getnote kb blogger-content |
| 订阅抖音博主 | getnote kb blogger-follow |
| 直播列表 | getnote kb lives |
| 直播详情 | getnote kb live |
| 订阅直播 | getnote kb live-follow |
| 使用 MCP 临时凭据直传本地文件到 OSS | getnote upload <file> |
| 查询文件约束 | getnote file-capabilities |
| CLI 已登录时获取上传 token | getnote file-token <extension> |
| CLI 已登录时提交 OSS 结果入库 | getnote file-add <topic_id> <directory_id> |
gnote 和短命令是稳定别名；旧环境没有别名时回退到 getnote kb directories/directory-create/directory-update/directory-delete。参数一律以目标命令 --help 为准。
选择知识库和权限
getnote kbs和getnote kbs-sub默认只查询DEFAULT。用户明确要书籍、客户档案或团队知识库时，分别传--scope BOOKSPACE、--scope CUSTOMER、--scope TEAMSPACE；不能把多个 Scope 混在同一分页结果里。- 用户问“我管理的/我的知识库”时执行
getnote kbs --scope <scope> -o json；问“我订阅的知识库”时执行getnote kbs-sub --scope <scope> -o json。订阅列表只包含他人创建且当前账号真实订阅的知识库，分别按has_more翻完页。 - 按名称和
scope匹配；同名或用户意图不明确时让用户选择，不猜topic_id。目标名称既可能是知识库也可能是文件夹时，先问清楚。 - 订阅知识库通常只读。若列表结果明确返回角色或可写标记，按真实字段判断；当前 CLI 契约未保证权限字段时，不得声称已经预检为 owner/admin，可在用户明确授权后尝试写入，并忠实处理权限失败。
- 普通成员写入失败时明确说明权限不足，不尝试绕过。当前不代替用户新建团队知识库。
按书名、作者定位，再选择内容范围
用户要某本书或某位作者的划线时，先定位书籍知识库，不把语义搜索的 Top-K 当全量。--query 只匹配知识库名或书名，--author 匹配书籍作者；两个参数同时传时是 AND，不是任选其一。
- “找《某本书》的笔记”：传
--query，查询词只放书名，不把“我的笔记”“全部划线”或作者名拼进去。 - “找某位作者的书籍笔记”：只传
--author，省略--query，再按返回书籍库读取。用户要该作者全部书籍时逐库遍历；仅要其中一本但候选不唯一时再消歧。 - “找某位作者写的《某本书》”：同时传书名
--query和作者--author。作者关键词误传 query 得到空列表不能解释为用户没有该作者的笔记。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago Changed · +2 lines bf72cab0706f
- 8d ago Changed · +35 lines · -15 tokens per session d01e8a2146b8
- 27d ago Changed · +13 lines · +20 tokens per session 3864aca7a276
- 1mo ago Changed 98e30196aacf
- 1mo ago First seen · 90 lines · 53 tokens per session scan A 41d86ec49160
getnote-kb is a skill published in the GitHub repository iswalle/getnote-cli (178 stars, last pushed 2d ago), licensed MIT. It adds 58 tokens to every session and 4,821 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
mnemon
Persistent memory CLI for LLM agents. Store facts, recall past knowledge, link related memories, manage lifecycle.
mnemon
Persistent memory CLI for LLM agents. Store facts, recall past knowledge, link related memories, manage lifecycle.
brain-ingest
The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI.
mnemon
Persistent memory CLI for Hermes Agent. Store facts, recall past knowledge, link related memories, manage lifecycle.
mnemon
Persistent memory for MiniMax Code. Recall durable context, store important facts and decisions, and link related memories with the mnemon CLI.
[object Object]
Read, search, and open notes in the user's "{{GRAPHNAME}}" Reflect graph via the reflect CLI. Use when the user asks about their notes, daily notes, journal, or anything they may have written down in Reflect.