Remove codegraph_explore tool in favor of native Explore agents

The hybrid approach (Claude's native Explore agents using codegraph tools)
is more effective than a custom explore tool because Explore agents already
know what format the main session needs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Colby McHenry
2026-01-19 21:14:52 -06:00
co-authored by Claude Opus 4.5
parent a4ddedb197
commit 47af81aee7
3 changed files with 21 additions and 362 deletions
+9 -19
View File
@@ -122,26 +122,16 @@ codegraph serve --mcp # Start MCP server
## MCP Tools Best Practices
When using CodeGraph MCP tools, follow these guidelines to minimize context usage:
These tools are designed to be used by **Explore agents** for faster codebase exploration:
### For Complex Tasks (features, refactoring, architecture)
Use `codegraph_explore` - it does intensive exploration internally and returns a condensed brief:
```
codegraph_explore(task: "implement user authentication with OAuth")
```
This replaces multiple tool calls and keeps your main context clean.
### For Simple Lookups
Use targeted tools directly:
- `codegraph_search` - Find symbols by name
- `codegraph_node` - Get details about one symbol
- `codegraph_callers/callees` - Understand usage patterns
### Context Usage Comparison
| Approach | Context Impact |
|----------|---------------|
| Multiple `codegraph_*` calls | High - each result stays in context |
| Single `codegraph_explore` | Low - returns condensed summary |
| Tool | Use For |
|------|---------|
| `codegraph_search` | Find symbols by name (functions, classes, types) |
| `codegraph_context` | Get relevant code context for a task |
| `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 |
### Important
CodeGraph provides **code context**, not product requirements. For new features, still ask the user about: