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) ```bash # Smart router — default first move agentmap --any <query> # Reuse / symbol definition agentmap --find <SymbolName> # Blast radius (exports, imports, dependents, related files) agentmap --relates <path/to/file.ts> # Token-budgeted ranked digest agentmap --map --tokens 400 agentmap --map --focus <path> --tokens 400 # Hub files (PageRank) agentmap --hubs # JSON for tools 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 + c...