| name | agentmap |
| description | Use for TypeScript/JavaScript codebase navigation — symbol lookup, blast radius, reuse checks, and repo orientation. Prefer agentmap before serial grep when exploring imports, exports, or where a symbol lives. Package is @raymondchins/agentmap (not the unrelated npm package agentmap). |
agentmap
Queryable, ranked import graph for TS/JS repos (PageRank hubs, symbol ranking, token-budgeted digest). Faster and more accurate than grep for structural questions.
When to use
- Where is X defined? / who imports this file? / what breaks if I edit this?
- Reuse check before adding a util, component, or type
- Session start — orient to a large monorepo cheaply
When not to use
- Raw string / config value search (try
agentmap --any first — layer 4 is live git grep)
- Non-TS/JS files, runtime call graphs, or full semantic "how does it work?" (use codebase search)
- Next-style
--feature on TanStack Router / non-app/ layouts (often empty)
Commands (run in repo root)
agentmap --any <query>
agentmap --find <SymbolName>
agentmap --relates <path/to/file.ts>
agentmap --map --tokens 400
agentmap --map --focus <path> --tokens 400
agentmap --hubs
agentmap --json --any <query>
Install: npm i -g @raymondchins/agentmap or npx @raymondchins/agentmap. Map cache: .claude/agentmap/ (gitignored).
Agent platforms
| Platform | Setup |
|---|
| Claude Code | agentmap --install-hooks (post-commit refresh + PreToolUse grep nudge) |
| Cursor / MCP clients | agentmap --mcp in MCP config, or Shell + commands above |
| This skill | agentmap --install-skill |
Workflow
- If the map may be stale after edits, run
agentmap (no flags) or rely on post-commit hook.
- Start with
agentmap --any <symbol or topic>.
- Before editing a hub file, run
agentmap --relates <that-file>.
- Fall back to grep only when agentmap returns no useful structure hit.
Package name
npx @raymondchins/agentmap --any Procedure
