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

| 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

MIT

Built on top of colbymchenry/codegraph.