kodegraf-cli 0.1.5

Your AI assistant doesn't understand your codebase. It reads files, guesses at function names, invents import paths, and hallucinates enum values. Then you fix its mistakes. Then it makes them again next session.

Kodegraf gives it a memory. It parses your code into a queryable graph — every function signature, every import path, every type definition — and serves that knowledge to your AI through MCP. Your assistant stops guessing. It looks things up.

Built in Rust. Parses 37,000 files in 46 seconds. Searches in 23ms. Zero runtime dependencies.

Install

cargo install kodegraf-cli kodegraf-mcp

Set Up (once per project)

cd your-project
kodegraf install

This single command handles everything: parses your codebase, builds the graph, registers the MCP server, and configures your editor. Open Claude Code (or Cursor, Windsurf, Zed) and start working.

What Happens Next

When your AI assistant needs to find a function, it queries the graph instead of grepping thousands of files. When it writes code, Kodegraf validates the imports, function calls, and enum values against what actually exists. When you switch branches, the graph updates automatically.

You: "How is authentication implemented?"

Without Kodegraf:                         With Kodegraf:
  Grep("auth") → 200+ matches              kodegraf_find("auth") → 3 results
  Read 8 files → 25K tokens                 Exact signatures, file:line
  Guesses import path → wrong               Verified import path → correct
  3 fix cycles                              Works first try

17 Tools

DiffGuard

Every time your AI writes code, Kodegraf checks it against the graph:

• Does the import path resolve to a real file?
• Does the function being called actually exist?
• Does the function signature match (parameter count, types)?
• Is the enum value valid?

Errors are caught before they reach your PR. Failures are recorded, patterns are detected, and prevention rules are generated automatically. The system gets smarter every session.

Performance

Tested on a production monorepo with 37,000 source files:

Parallel parsing with 8 threads. SQLite with WAL mode, FTS5 full-text search, 64MB cache. All queries use prepared statements.

Languages

TypeScript, JavaScript, Python, Go, Rust, Java, Ruby, C, C++, C#, Scala.

How It Integrates

kodegraf install sets up five layers automatically:

1. MCP Server — registers with your AI tool via .mcp.json
2. Instructions — prepends CLAUDE.md with "use Kodegraf tools first"
3. Hooks — auto-updates graph after every file edit (191ms, silent)
4. Skills — workflow templates for explore, review, debug, refactor
5. Auto-build — graph rebuilt on session start if empty or stale

Works with Claude Code, Cursor, Windsurf, Zed, and Continue.

CLI

kodegraf install            # Set up everything (one command)
kodegraf build              # Full graph build
kodegraf update             # Incremental update
kodegraf update --fast      # Hook mode (silent, <200ms)
kodegraf find <query>       # Find a symbol
kodegraf deps <file>        # File dependencies
kodegraf dependents <file>  # Reverse dependencies
kodegraf impact             # Blast radius of current changes
kodegraf check <file>       # Validate a file (DiffGuard)
kodegraf eval               # Run benchmarks
kodegraf status             # Graph statistics

Architecture

Four Rust crates. Two binaries. One SQLite database.

Development

cargo build --workspace        # Build
cargo test --workspace         # 112 tests
cargo clippy --workspace       # Lint

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md. Kodegraf is local-only — no network calls, no telemetry, no cloud.

License

MIT