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:Name and path/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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ozgurcdgograph.svg)](https://yunodb.com/tools/ozgurcdgograph?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ozgurcdgograph?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ozgurcdgograph.svg" alt="Featured on YunoDB" height="20"></a>