dsh-tool-codegraph
CodeGraph navigation tools for DeepSeek Harness.
A DSH plugin that wraps the open-source codegraph CLI
(an AST/tree-sitter code index) into ten focused agent tools — status, search,
callers/callees, impact, explore, and more.
This package is a thin wrapper. All indexing and querying is done by the
codegraph CLI — install it first
and make sure its binary is onPATH.
⚡️ Highlights
- 🧭 Orientation-first workflow — usage rules (
status → sync → explore → targeted lookups) are injected into the agent system prompt automatically. - 🧰 Ten focused tools, one per operation — no mega-tool with an
actionparameter. - ⚡ O(1) indexed lookups — light outputs for the main session, heavy explore builds routed to subagents.
- ⚠️ Honest about soundness — callers/callees/impact can miss dynamic-dispatch edges; the prompt tells the model when to fall back to
grep.
🛠 Requirements
- Node
^22.19 || >=24 - The
codegraphCLI available onPATH(override via theexecutableconfig key)
🚀 Quick Start
1. Install the plugin
dsh plugin add --profile web @m1khal3v/dsh-tool-codegraph2. Check the wrapped CLI
codegraph statusIf the binary is missing, the tools reply with an install hint and the agent
falls back to grep-based search.
3. Initialize the index — your call
There is deliberately no init tool in the set above: following the codegraph
project's own recommendation, indexing should be kicked off by the user, not by
an agent. When codegraph status reports a missing index, run it yourself:
codegraph initUntil you do, the tools report the missing index and the agent keeps working
with other search tools.
🧰 Tools
| Tool | Purpose | Output |
|---|---|---|
codegraph_status |
Index health and statistics | light |
codegraph_sync |
Sync changes since the last index | long |
codegraph_search |
Find a symbol by name | light |
codegraph_explore |
Map an area with verbatim source and call paths | heavy |
codegraph_callers |
Who calls this symbol (unsound) | light |
codegraph_callees |
What this symbol calls | light |
codegraph_impact |
Blast radius of changing a symbol | light |
codegraph_node |
One symbol's details or a file view | light |
codegraph_files |
Project file structure from the index | light |
codegraph_affected |
Find test files affected by changed source files | light |
⚙️ Configuration
| Key | Default | Description |
|---|---|---|
executable |
codegraph |
Binary name or path of the wrapped CLI |
queryTimeoutMs |
10000 |
Timeout for regular commands |
initTimeoutMs |
60000 |
Timeout for init / sync |
🧑💻 Development
pnpm install
pnpm run verify # typecheck + test
pnpm run build📄 License
Built on top of colbymchenry/codegraph.