gograph

Overview

gograph is a fast, local-only CLI tool designed to generate repository structures and improve IDE context awareness specifically for Go codebases. It builds a compact graph of packages, symbols, calls, routes, config reads, tests, and code-quality signals so AI agents can navigate Go repositories with fewer raw file reads. Unlike language servers like gopls, which are optimized for human IDEs, gograph is specifically built for terminal-based LLMs to save context tokens by extracting exact structural slices in native Markdown format.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• boundaries

  Verify package architecture constraints using boundaries.json

  Try:Check for architecture boundary violationsTry:Enforce package import rules
• callers

  See what functions call a specific symbol

  Try:Find all functions that call ValidateTokenTry:Who calls this method?
• callees

  See what a specific function calls

  Try:Show what InitServer callsTry:List all function calls in this method
• complexity

  Calculate cyclomatic complexity for functions

  Try:Show complexity of the Run functionTry:List most complex functions in the codebase
• focus

  Generate highly targeted context for a specific package

  Try:Get focused context for internal/auth packageTry:Show me only the service layer code
• hotspot

  Rank functions by incoming call count

  Try:Show top 10 most called functionsTry:Find the busiest methods in the codebase
• impact

  View the full blast radius of a symbol

  Try:Show impact of ValidateToken changesTry:What depends on this function?
• interfaces

  See which interfaces a struct satisfies

  Try:Show interfaces implemented by UserServiceTry:Which structs satisfy this interface?
• path

  Find the shortest call chain between two symbols

  Try:Find path from CreateUser to sqlTry:Show call chain between these functions
• context

  Get node, source, callers, callees, and tests in one response

  Try:Get full context for ValidateTokenTry:Show comprehensive info about this function
• trace

  Trace an error string backwards to entry points

  Try:Trace back 'parse failed' errorTry:Find where this error originates
• deps

  Show direct or transitive import dependencies for a package

  Try:Show dependencies for internal/authTry:List all transitive imports for this package

Comparable tools

Installation

# MacOS / Linux (via Homebrew)
brew install ozgurcd/tap/gograph

# Or using Go:
go install github.com/ozgurcd/gograph/cmd/gograph@latest

FAQ

How is gograph different from language servers like gopls?

While gopls has similar AST and type data, connecting an AI agent to it is difficult and inefficient. gograph extracts exact structural slices in native Markdown format rather than just file coordinates, saving tokens and providing better context for AI agents.

Does gograph support languages other than Go?

Currently gograph only parses and maps Go codebases. However, the architecture is extensible and contributions for other languages are welcome.

Compare gograph with