gograph
Local-only Go static analysis engine with a built-in MCP server. Gives AI coding agents deterministic structural awareness: call graphs, impact analysis, symbol
What is gograph?
Local-only Go static analysis engine with a built-in MCP server. Gives AI coding agents deterministic structural awareness: call graphs, impact analysis, symbol search, and more.
Overview of gograph
What it is
gograph is a local-only static analysis engine for Go repositories, with a built-in MCP server. It builds a structural graph of your code, optionally enriched with type-checked CHA/SSA analysis, to give AI coding agents deterministic structural awareness such as call graphs, impact analysis, and symbol search. It operates without embeddings or a hosted code index, and does not execute target code during indexing.
Key features
- Builds a local structural graph of Go repositories with optional precise (type-checked) enrichment.
- Provides CLI and MCP workflows for tracing callers, interface implementations, and planning change impact.
- Supports symbol queries with selectors like
path/to/file.go:Nameandpath/to/file.go:Receiver.Method. - Includes commands for summary, hotspot, flow, context, explore, plan, review, and changes.
- Offers freshness checks, session audits, and compliance scoring for operational use.
- Excludes linked or non-regular files from Go tool inputs for safety.
Use cases
- Helping AI coding agents understand code structure before refactoring.
- Planning change impact by tracing callers and callees.
- Enforcing architecture rules without a hosted index.
- Reviewing uncommitted changes and evaluating risk.
Getting started
bash # Install brew install --cask ozgurcd/tap/gograph # or: go install github.com/ozgurcd/gograph/cmd/gograph@latest # Confirm installation and detect PATH shadowing gograph doctor --json # Build a type-enriched precise graph gograph build . --precise gograph stats # Start with repository-wide results gograph summary gograph hotspot --top 5 gograph flow --no-tests For more commands, see the repository README.
License and pricing
The license is MIT, and the project is open source. Pricing is not stated; it is an open-source tool.
Based on the project's public README and repository metadata.