Getnote Tag

If you're working with Get笔记 (a note-taking app) and need Claude to manage tags programmatically, this is your connector. It wraps the getnote CLI to list, add, and remove tags on notes, with proper handling for the three tag types: AI-generated, manual, and system (which are protected from deletion). The main gotcha is that removing tags requires numeric IDs, not names, so you'll always list first then delete. It's straightforward CLI orchestration, nothing fancy, but it saves you from manually explaining the getnote tag syntax every time you want Claude to organize your notes by topic or project.

skills.sh installs: 1.2K
GitHub stars: 179
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add iswalle/getnote-cli --skill getnote-tag --agent claude-code

Installs into .claude/skills of the current project.

Files

得到大脑标签

通过官方 getnote CLI 管理真实标签。不要自己构造标签 ID，也不要把标签名误当成删除参数。机器调用统一使用 -o json；退出码为 0 但 success=false 仍是失败。

路由与安全边界

用户意图	命令	不能做什么
“这条笔记有哪些标签”	`getnote tag list <note_id>`	不自动添加或删除。
“给这条笔记加上产品优化”	`getnote tag add <note_id> <tag>`	只新增指定标签，不覆盖原标签。
“删掉这个标签”	先 `tag list`，再 `getnote tag remove <note_id> <tag_id>`	不能把标签名称直接当作 `tag_id`。
“替换为这些标签”	先读取当前标签，再交给 `getnote note update --help`	属于覆盖性操作，必须先确认。

笔记 ID、标签 ID 及任何雪花 ID 始终作为字符串原样传递。系统标签不可删除；权限不足、标签不存在或笔记不存在时不能说“已经删掉”。

命令结果与用户呈现

查看标签

getnote tag list <note_id> -o json

成功 JSON：

字段	含义	回复规则
`success=true`	标签读取成功	才能展示列表。
`data.note_id`	实际读取的笔记	必须与目标笔记一致。
`data.tags[].id`	标签真实 ID	仅用于后续删除，不必在普通回复中暴露。
`data.tags[].name`	标签名称	展示给用户。
`data.tags[].type`	普通/系统等标签类型	系统类型明确不能删除。

若 tags=[]，回复“这条笔记目前没有标签”，这是成功结果。

添加标签

getnote tag add <note_id> "产品优化" -o json

成功 JSON 必须有 success=true、data.note_id 与更新后的 data.tags[]。回复“已添加「产品优化」”，并在用户要求时列出当前全部标签；不要说“已替换标签”。如果结果没有新的标签集合，先再执行一次 tag list 核验，再向用户确认。

删除标签

getnote tag remove <note_id> <tag_id> -o json

SKILL.md on GitHub

Details

Repository: github.com/iswalle/getnote-cli
Categories: Release Management, CLI & Terminal
First seen: Jun 3, 2026

More from iswalle/getnote-cli

All 5