# tag-agent

Cleans up vault tag taxonomy and removes duplicates. Useful for organizing deeply nested notes in Obsidian.

- subagent · `type=agent` · Claude Code · 746 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/obsidian-ops-team/tag-agent.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/tag-agent

## What it does

The subagent handles taxonomy consistency across note vaults. It detects duplicate labels, merges variations like hyphenated and slash paths, and enforces correct casing for names such as LangChain or PostgreSQL. Hierarchies are restricted to three levels deep.

The agent relies on `Read`, `MultiEdit`, `Bash`, and `Glob` tools. Its core workflow centers around `tag_standardizer.py`, which offers a `--report` argument to generate a dry-run analysis before applying any document updates.

Without the `PyYAML` package installed in the environment, the Python automation will fail immediately. Running a preliminary report is necessary to avoid unintended vault changes.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent obsidian-ops-team/tag-agent
```

2. **Manually: put the files in place**
- File: `.claude/agents/tag-agent.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/tag-agent.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/tag-agent.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/obsidian-ops-team/tag-agent.md

## When to use it
- merge duplicate tags and disparate label variations
- organize vault tags into clean parent-child hierarchies
- create an inconsistency report prior to modifying files
- enforce proper casing across product and technology names

## Example prompts
- Run an audit on all vault tags and produce a taxonomy report
- Standardize product casing and merge duplicate technology tags
- Reorganize top-level categories into a nested tag hierarchy

## Similar
- [context-manager](https://affpapa.org/en/nevibecode/agents/context-manager.md) — subagent · 10638 installs
- [code-architect](https://affpapa.org/en/nevibecode/agents/code-architect.md) — subagent · 1439 installs
- [search-specialist](https://affpapa.org/en/nevibecode/agents/voltagent-community-search-specialist.md) — subagent · 6886 installs
- [content-marketer](https://affpapa.org/en/nevibecode/agents/voltagent-community-content-marketer.md) — subagent · 4038 installs
- [product-manager](https://affpapa.org/en/nevibecode/agents/product-manager.md) — subagent · 1104 installs
- [project-manager](https://affpapa.org/en/nevibecode/agents/project-manager.md) — subagent · 1064 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 804 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md