Skip to main content

BATHO

Give your AI coding agent a map of your codebase.
10x fewer tokens. Zero hallucinations. Ship faster.

BATHO β€” zsh
typing…
# Build full hypergraph (baseline)
➜~β–‹

Works with your AI coding agent

Claude CodeCursorWindsurfAntigravityGemini CLIClineOpenCodeAider
Why Batho

The Problem Batho Solves

AI coding agents are powerful β€” but they burn tokens reading files and hallucinate when context is thin. Batho gives your agent a structured code graph so it works smarter, not harder.

Slash Token Costs

Your agent queries a graph instead of reading entire files. 10x fewer tokens per task β€” no more dumping your repo into the LLM.

Eliminate Hallucinations

Deterministic, tree-sitter-parsed relationships. Your agent gets facts, not guesses β€” zero hallucinations on structural queries.

Agent Superpowers

Bug tracking, security audits, refactoring, code review β€” your agent handles more, accurately. When cost and quality are solved, automation widens with imagination.

10x
Less Tokens
vs. raw file injection
0
Hallucinations
deterministic, not guessed
40+
Languages
tree-sitter powered
8
AI Agents
MCP-compatible out of the box
>95%
Cache Hit
typical PR changes
Workflow

How It Works

From source code to AI-ready graph in four steps

01

Build

Parse your entire codebase into a structured hypergraph with cross-file symbol resolution.

batho build --root .
~3s for 300 files
02

Patch

Apply incremental updates 10-100x faster than full re-indexing using native content hashing.

batho patch --root .
~85ms per PR
03

Export

Export a transportable ZIP artifact by default, or use --json for LLM-optimized views.

batho export --root .
12 MiB typical
04

Verify

Execute integrity checks and diagnostic routines to repair database corruption or inconsistencies.

batho fix --dry-run
Cryptographic
Features

Everything You Need

From multi-language parsing to zero-copy storage, Batho gives your agent the tools to understand any codebase.

Works With Your Stack

Python, TypeScript, Rust, Go, Java, and more. Batho parses 40+ languages so your AI agent understands your entire codebase β€” no blind spots.

Learn more β†’

Track Codebase Evolution

Versioned snapshots and incremental diffing let your agent understand what changed and why β€” across every commit.

Learn more β†’

Zero-Copy Performance

Apache Arrow IPC storage means zero-copy, memory-mapped reads. Your agent queries the graph instantly.

Learn more β†’

Reconstruct Anything

Reconstruct any file byte-for-byte from the graph. Cryptographic hash integrity means nothing is lost.

Learn more β†’

Zero Config to Start

Batho runs with zero config. Customize with a single YAML file when you need control.

Learn more β†’

MCP-Native

Works with Claude Code, Cursor, Windsurf, Antigravity, Gemini CLI, Cline, OpenCode, and Aider. One MCP config, zero hassle.

Learn more β†’
Capabilities

What Your Agent Can Do

When cost and quality are solved, automation widens with imagination. Here's what becomes possible.

Bug Tracking

Trace root causes across files. Your agent follows the graph β€” not grep β€” to find where bugs originate.

Security Audits

Map attack surfaces, trace data flows, and identify vulnerable patterns β€” structurally, not heuristically.

Refactoring

See every dependency before you rename. Your agent knows the blast radius of every change.

Code Review

Review PRs with full context. Your agent understands what changed, what depends on it, and why it matters.

Onboarding

New team members ask your agent questions. It answers with structural facts β€” not file dumps.

CI/CD Integration

Build the graph in CI, export an artifact, and ship it with your deploy. Agents query locally β€” no server needed.

Integrations

Works With Your AI Agent

Batho connects to any MCP-compatible coding agent. One config, zero hassle. Your agent gets a code graph instead of a file dump.

Claude Code

Anthropic's terminal-first coding agent with the deepest MCP integration.

  • 1M context window + Batho graph = near-zero hallucination on structural queries
  • Hook system can trigger batho patch automatically after edits
  • 10 MCP tools available as mcp__batho__* in every session
Setup Batho with Claude Code
Terminal
claude mcp add batho -- batho mcp
Quick Start

Get Started in Seconds

Two paths to graph-powered coding. Pick the one that fits your workflow.

Setup with your AI Agent

1 command Β· ~30 seconds

Download the skill file and give it to your agent. It installs Batho, builds the graph, and configures MCP for all detected clients.

Full guide
$curl -O https://raw.githubusercontent.com/sageoz/batho/main/SKILL.md

Then tell your agent: Read SKILL.md and set up Batho for this repo

Manual CLI Setup

3 commands Β· ~1 minute

Prefer the terminal? Three commands β€” install, build, start MCP server. No agent required.

CLI quick start
$pip install batho && batho build --root . && batho mcp

No agent needed β€” run everything from your terminal. batho mcp starts the MCP server.

Open Source

Give your AI agent a code graph β€” not a file dump.

Index in one command. Connect via MCP. Your agent gets structural intelligence with zero-copy speed, 10x fewer tokens, and zero hallucinations.

  • One command to build
  • Works with 8+ AI agents
  • No server required