# Getnote Tag

> Manage note tags in Get笔记 via the getnote CLI

- Skill: `om-scogo/getnote-tag` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add om-scogo/getnote-tag`
- Raw SKILL.md: https://api.skillmd.com/api/skills/om-scogo/getnote-tag/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: om-scogo (https://skillmd.com/u/om-scogo)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/om-scogo/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.