Graphize

LLM-powered CLI for transforming polyglot codebases into queryable knowledge graphs.

Features

• 🌍 Multi-Language Support - Go, Java, TypeScript, and Swift with extensible provider interface
• 📊 AST Extraction - Fast, deterministic extraction of functions, types, and relationships
• 🤖 LLM Enhancement - Optional semantic analysis to discover implicit dependencies
• 🔍 Graph Queries - BFS/DFS traversal, path finding, community detection
• 📈 Analysis Reports - God nodes, surprising connections, corpus health, suggested questions
• 💡 Node Explanation - Get context with community membership and centrality metrics
• 🌐 MCP Server - Integrate with Claude Desktop and Claude Code
• 🔌 Platform Installers - One-command setup for Claude, Cursor, Copilot, Codex, Gemini, Aider
• 📤 Multiple Exports - HTML, TOON, JSON, GraphML, Neo4j Cypher, Obsidian vault
• 👁️ Watch Mode - Auto-rebuild graph on file changes
• 🔗 Git Hooks - Automatic analysis on commit/checkout
• 📝 Doc Extraction - Link markdown/text documentation to code entities

Quick Start

# Build
go build -o graphize ./cmd/graphize

# Initialize a new graph database
graphize init

# Add your repository (Go, Java, TypeScript, Swift)
graphize add .

# Extract the graph (AST-based)
graphize analyze

# Generate an analysis report
graphize report

# Export interactive visualization
graphize export html -o graph.html

Two-Step Extraction

Graphize provides a two-step extraction pipeline:

1. Deterministic AST extraction - Fast, reproducible, always available
2. LLM semantic extraction - Optional, adds inferred relationships and rationale

# Step 1: AST extraction
graphize analyze

# Step 2: Prepare for LLM (optional)
graphize enhance --json > files.json

# Step 3: Merge LLM results
graphize merge -i agents/graph/semantic-edges.json

CLI Commands

Command	Description
graphize init	Initialize graph database
graphize add <repo>	Track a repository
graphize status	Show tracked sources
graphize analyze	Extract AST-based graph
graphize enhance	Prepare for LLM extraction
graphize merge	Merge semantic edges
graphize query	Query the graph
graphize path <A> <B>	Find shortest path between nodes
graphize explain <node>	Get node context with community and centrality
graphize report	Generate analysis report
graphize report --health	Assess corpus health and graph value
graphize benchmark	Show token reduction statistics
graphize watch	Auto-rebuild on file changes
graphize hook install	Install git hooks
graphize install <platform>	Install AI assistant integrations
graphize export html	Cytoscape.js visualization
graphize export htmlsite	Multi-page documentation site
graphize export obsidian	Obsidian vault with wikilinks
graphize export cypher	Neo4j Cypher statements
graphize serve	Start MCP server

MCP Server Integration

Integrate with Claude Desktop or Claude Code:

{
  "mcpServers": {
    "graphize": {
      "command": "graphize",
      "args": ["serve", "-g", "/path/to/.graphize"]
    }
  }
}

Output Formats

Format	Use Case
TOON	Agent-friendly, token-efficient (default)
JSON	Machine-readable, full fidelity
HTML	Interactive Cytoscape.js visualization
HTML Site	Multi-page documentation site with per-service graphs
GraphML	Import into Gephi, yEd, Cytoscape desktop
Cypher	Neo4j CREATE statements
Obsidian	Wiki-style vault with wikilinks

Storage

Uses GraphFS for git-friendly storage:

.graphize/
├── manifest.json      # Tracked sources
├── nodes/             # One file per node
├── edges/             # One file per edge
└── cache/             # Per-file extraction cache

Documentation

Full documentation at plexusone.github.io/graphize

• Getting Started
• CLI Reference
• MCP Server
• Architecture

License

MIT