gograph
Stop burning tokens on grep. Give your AI agent a graph.
gograph builds a local, AST-aware call graph of your Go repository and exposes 50+ query tools via CLI and MCP so coding agents can navigate packages, symbols, call chains, routes, SQL, env vars, and tests — without reading raw files.
Zero network. Zero execution. Zero secrets read.
gographis purely static analysis — it never runs your code, makes API calls, or opens non-.gofiles.
Quick Start
# Install
brew install ozgurcd/tap/gograph
# Build the graph
gograph build . --precise
# Try it — who calls ValidateToken?
gograph callers "ValidateToken"
# Full context in ONE call (node + source + callers + callees + tests)
gograph context "ValidateToken"
# Change plan before editing (callers, tests, routes, SQL, env risk)
gograph plan "ValidateToken"Why gograph?
Benchmarked on gograph's own codebase (70 files, 518 symbols, 16 packages):
| Task | grep -rn |
gograph |
Savings |
|---|---|---|---|
Find callers of loadGraph |
158 noisy lines (comments, docs, vars) | 56 exact structural call sites | ~65% noise eliminated |
| Locate symbol definitions | 842 lines matching "Symbol" | 83 true type/method declarations | ~90% noise eliminated |
| Read one function body | cat dumps 180+ lines of the whole file |
source extracts the exact 12-line function |
~93% fewer tokens |
| Understand a symbol fully | 4–5 separate tool calls | 1 call: context bundles everything |
80% fewer tool calls |
