agent-tags

AI agents waste most of their tokens finding the right code, not writing it. @agents tags embed purpose, constraints, and relationships directly in your source — so agents know what matters before touching a line.

See how it works GitHub

Get started in seconds

Works with any language. No configuration needed.

$ npm install -g agent-tags

Or build from source:
cargo install --path git-agent-tags

Any language

Tags live in comments. TypeScript, Python, Rust, Go, Ruby, Java, C++, Swift, Lua, Haskell. If it has comments, it works.

Validated references

Every Related: path is checked. Broken references never reach main.

$ agent-tags hook --install
✓ Installed pre-commit hook.

$ agent-tags check
✓ No issues found.

SQLite index

Full-text search over all tags. Builds in milliseconds.

$ agent-tags index
✓ 142 files, 87 headers, 156 edges

$ agent-tags query search "auth"
$ agent-tags query deps src/auth.ts

Agent skill included

Drop the skill into your repo and compatible agents read tags before editing, update them after, and validate on commit.

$ npx degit cabljac/agent-tags/.agents/skills/agent-tags \
    .agents/skills/agent-tags
# Claude Code, Cursor, Copilot, etc.
# pick it up automatically