lzehrung/codegraph

codegraph

Codegraph is a small multi-language code analysis library and CLI for understanding repos quickly. It builds dependency graphs, symbol indexes, go-to-definition results, find-references results, semantic chunks, architecture drift reports, and PR review and impact artifacts across source languages plus graph-first document, stylesheet, and template formats.

It is built for agent and human workflows that need repo structure fast without standing up a full editor or LSP stack.

Table of contents

• Why Codegraph
• Features
• Quick start
• CLI examples
• Agent setup
• Using as a library
• Common workflows
• Supported languages
• Documentation
• Installation options
• FAQ
• Contributing and releases

Why Codegraph

Use Codegraph when you need fast structural answers about a repo without relying on a full editor session or language-server setup.

• Triage an unfamiliar codebase with one pass that highlights hotspots, unresolved imports, cycles, and next commands to run.
• Review diffs with changed symbols, graph deltas, likely regression tests, and risk signals that agents or humans can consume directly.
• Export graph data as JSON, Mermaid, DOT, or SQLite, then inspect it from scripts or the browser graph viewer app.
• Keep one workflow across source languages, monorepos, and graph-first document and template formats instead of stitching together separate tools.

inspect returns a bounded repo summary plus next commands:

{
  "backend": {
    "native": { "available": true }
  },
  "files": {
    "total": 80,
    "byLanguage": { "ts": 80 }
  },
  "hotspots": [
    {
      "file": "/workspace/codegraph/src/indexer.ts",
      "fanIn": 16,
      "fanOut": 27,
      "score": 59
    }
  ],
  "duplicates": {
    "total": 1