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 on PATH.

⚡️ 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 action parameter.
• ⚡ 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 codegraph CLI available on PATH (override via the executable config key)

🚀 Quick Start

1. Install the plugin

dsh plugin add --profile web @m1khal3v/dsh-tool-codegraph

2. Check the wrapped CLI

codegraph status

If 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 init

Until you do, the tools report the missing index and the agent keeps working with other search tools.

🧰 Tools

⚙️ Configuration

🧑‍💻 Development

pnpm install
pnpm run verify    # typecheck + test
pnpm run build

📄 License

MIT

Built on top of colbymchenry/codegraph.