dsh-tool-codegraph

Getting an agent to navigate a large codebase structurally has always been tricky: grep gives you text matches without semantics, and while the codegraph CLI offers indexed AST and tree-sitter queries, its raw command-line interface was not designed with agent workflows in mind. dsh-tool-codegraph wraps codegraph into ten focused, single-purpose tools so an agent can follow a clean orientation-first flow — check status, sync the index, explore a region, then drill into targeted lookups — instead of fumbling with a monolithic action parameter.

Each of the ten tools (status, sync, search, explore, callers, callees, impact, node, files, affected) returns a concise light output. Only explore, which emits verbatim source and full call paths, is tagged heavy and routed to a subagent, keeping the main session context lean. The plugin also injects orientation-first usage rules into the system prompt automatically and is upfront about soundness limits: callers, callees, and impact can miss dynamic-dispatch edges, and the prompt tells the model when to fall back to grep rather than over-trust the index.

It suits developers and teams who rely on agents for code comprehension, refactoring impact assessment, and call-chain tracing in mid-sized or large projects. You need the codegraph CLI already on your PATH and Node 22.19 or later. If you want your agent to read structure instead of guessing, this plugin is a lightweight bridge with zero re-indexing overhead on your side.