github/codegraph
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Add codegraph_explore tool for comprehensive single-call code exploration

Browse Source 
Introduces a new MCP tool that performs deep code exploration in a single call, returning comprehensive context with full source code sections grouped by file and relationship mapping. Designed to replace multiple codegraph_node + file read operations for thorough understanding of code topics. Updates documentation to position explore as the primary tool for deep exploration questions.
This commit is contained in:
Colby McHenry
2026-04-03 16:35:27 -05:00
parent 4af51f565b
commit b927492bc0
3 changed files with 281 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/installer/claude-md-template.ts
+4 -1
View File
@@ -20,13 +20,16 @@ CodeGraph builds a semantic knowledge graph of codebases for faster, smarter cod
| Tool | Use For |
|------|---------|
| \`codegraph_context\` | Get relevant code context for a task (great starting point) |
| \`codegraph_explore\` | **Deep exploration** — comprehensive context for a topic in ONE call (replaces Explore agents) |
| \`codegraph_context\` | Quick context for a task (lighter than explore) |
| \`codegraph_search\` | Find symbols by name (functions, classes, types) |
| \`codegraph_callers\` | Find what calls a function |
| \`codegraph_callees\` | Find what a function calls |
| \`codegraph_impact\` | See what's affected by changing a symbol |
| \`codegraph_node\` | Get details + source code for a symbol |
**For deep exploration questions** (e.g., "how does the undo/redo system work?"), use \`codegraph_explore\` directly. It returns full source code sections from all relevant files in a single call — no need to spawn an Explore agent.
**Do NOT tell Explore agents to use codegraph tools.** Testing shows Explore agents use codegraph for discovery then still read all the same files — making them slower, not faster. Codegraph's value is in the main session where it replaces the need for exhaustive file reading.
### If \`.codegraph/\` does NOT exist