Getnote Tag
List, add, and remove Get笔记 tags on notes via the authenticated getnote CLI so agents organize your knowledge base.
Overview
getnote-tag is an agent skill for the Operate phase that manages Get笔记 note tags through the getnote CLI list, add, and remove commands.
Install
npx skills add https://github.com/iswalle/getnote-cli --skill getnote-tagWhat is this skill?
- tag list / tag add / tag remove commands with JSON output (-o json)
- Documents tag types: ai, manual, and non-deletable system tags
- tag remove requires numeric tag ID from list—never delete by name alone
- Bulk tag replace via getnote note update --tag when renaming sets
- Exit code 0 success contract; errors on stderr for agent parsing
- skill version 0.3.0 documented in SKILL frontmatter
Adoption & trust: 602 installs on skills.sh; 127 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your agent keeps mistyping tag names or trying to delete system tags because Get笔记 removals need tag IDs and type rules.
Who is it for?
Builders already using Get笔记 and getnote auth who want agents to maintain tags during daily note workflows.
Skip if: People without Get笔记 accounts or those who only need full note CRUD without tag-specific operations.
When should I use this skill?
Managing Get笔记 tags after authentication when you have a note_id and need list, add, remove, or bulk replace via CLI.
What do I get? / Deliverables
Notes gain correct manual tags and shed obsolete ones via verified CLI steps, with JSON you can chain into other getnote skills.
- Updated tag set on target note
- JSON tag inventory for downstream agent steps
Recommended Skills
Journey fit
How it compares
Narrow tag facet of the getnote CLI—not a full note editor; pair with getnote note skills for content changes.
Common Questions / FAQ
Who is getnote-tag for?
Solo builders automating Get笔记 with Claude Code or Cursor who need reliable tag list, add, and remove steps.
When should I use getnote-tag?
During Operate when cleaning up tags after a launch, re-labeling research notes, or syncing manual labels before exports—after getnote auth is healthy.
Is getnote-tag safe to install?
Review the Security Audits panel on this page; the skill runs authenticated CLI calls that can change note metadata in your Get笔记 account.
SKILL.md
READMESKILL.md - Getnote Tag
# getnote-tag Skill Add, list, and remove tags on notes. ## Prerequisites - `getnote` CLI installed and authenticated (`getnote auth status` should show "Authenticated") ## Commands ### List tags on a note ``` getnote tag list <note_id> ``` Returns all tags with their IDs and types. Tag types: - `ai` — auto-generated by AI - `manual` — added by the user - `system` — system tag (**cannot be deleted**) ```bash getnote tag list 1896830231705320746 getnote tag list 1896830231705320746 -o json ``` --- ### Add a tag ``` getnote tag add <note_id> <tag> ``` ```bash getnote tag add 1896830231705320746 工作 ``` --- ### Remove a tag ``` getnote tag remove <note_id> <tag_id> ``` > ⚠️ Requires **tag ID** (integer from `tag list`), not tag name. > ⚠️ `system` type tags cannot be removed. ```bash # Step 1: get tag IDs getnote tag list 1896830231705320746 -o json # Step 2: remove by tag ID getnote tag remove 1896830231705320746 123 ``` --- ## Agent Usage Notes - `tag list -o json` returns `{"note_id":"...","tags":[{"id":"...","name":"...","type":"..."}]}` (flat, no `success` wrapper). - `tag remove` takes a **numeric tag ID**, not a name — always call `tag list` first. - To replace all tags at once, use `getnote note update --tag "tag1,tag2"` instead. - Exit code `0` = success; non-zero = error. Error details go to stderr.