back
loading skill details...
Manage note tags in Get笔记 via the getnote CLI
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)
getnote tag list 1896830231705320746
getnote tag list 1896830231705320746 -o json
Add a tag
getnote tag add <note_id> <tag>
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.
# 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.don't have the plugin yet? install it then click "run inline in claude" again.