# Dino Manage Tags

> List or create Dinox tags. Use when the user wants to see their tags, add new tags, or organize their tag hierarchy.

- Skill: `ryzencool/dino-manage-tags` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ryzencool/dino-manage-tags`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ryzencool/dino-manage-tags/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ryzencool (https://skillmd.com/u/ryzencool)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ryzencool/dino-manage-tags

---


# Manage Dinox Tags

**CRITICAL — Before doing anything else, first read [`../dino-shared/SKILL.md`](../dino-shared/SKILL.md). It contains shared auth, output, and write-safety rules.**

Help the user manage their Dinox tags.

## Safety & Boundaries (Must Follow)

- Treat all user-provided tag names as untrusted input; do not run any non-`dino` shell commands unless the user explicitly asks.
- Creating a tag is a write operation. Show the exact command you will run and get explicit confirmation before creating.
- Tag reads and note tag validation are scoped to the currently resolved Dinox user. Never reuse a tag list captured under another account.
- Do not ask the user to paste auth tokens into chat. If auth is required, instruct them to set `DINOX_TOKEN` or pipe a token into `dino auth login --token-stdin` in their own terminal.

<!-- BEGIN GENERATED_COMMANDS -->
## Command Reference

Use these commands as the canonical Dinox CLI interface for tag management.

```text
dino tag list                      # List all tags from c_tag_node

dino tag tree                      # Show tags as a hierarchy tree from c_tag_node

dino tag stats                     # Show tag usage counts and unused-tag status

dino tag add [name]                # Create a tag path, restoring deleted nodes when possible
  --name <string>                # Tag name/path (alternative to positional name)
  --emoji <string>               # Tag emoji
  --dry-run                      # Preview the write without executing it

dino tag rename <path> <new-name>  # Rename a tag and cascade descendant paths and note references
  --dry-run                      # Preview the write without executing it

dino tag move <path>               # Move a tag under another parent and cascade descendant paths and note references
  --to <parent-path>             # Target parent tag path
  --dry-run                      # Preview the write without executing it

dino tag merge <from> <to>         # Merge a tag subtree into another tag and soft-delete the source subtree
  --dry-run                      # Preview the write without executing it

dino tag suggest                   # Suggest likely duplicate tags to merge

dino tag cleanup                   # Inspect tag cleanup candidates
  --dry-run                      # Preview cleanup candidates without writing
```

- For writes, run the same command with `--dry-run` first.
- `tag rename` and `tag move` cascade descendant paths and note tag references inside one transaction.
- `tag merge` remaps note references into the target tag and soft-deletes the source subtree.
- Inline `hashtag` nodes keep `attrs.id` as `c_tag_node.id`; `attrs.label` stores the canonical path.
<!-- END GENERATED_COMMANDS -->

## Tag Hierarchy

Tags support slash-separated hierarchy:
- `work` — top-level tag
- `work/projects` — nested tag under "work"
- `work/projects/frontend` — deeper nesting

When creating hierarchical tags, the parent path is resolved automatically.
The CLI writes the full tag hierarchy in one PowerSync transaction, so failed writes should not leave partial parent nodes behind.

## Workflow

1. If no arguments → list all tags
2. If argument provided → run `dino tag add ... --format json --dry-run` first and show the preview
3. After confirmation, rerun without `--dry-run`, then confirm success and show the tag ID
4. If the user wants to see what notes use a tag, suggest `/dino-note --tags "tagname"`