Skip to main content

Quick Start

Get running in 30 seconds:

# Install
uv add batho
# or
pip install batho

# Build full code graph for your repository (baseline)
batho build --root . --verbose

# Auto-detect and patch changes incrementally
batho patch --root . --verbose

# Export transport artifact (default)
batho export --root .

# Or export JSON view (e.g. storage view)
batho export --root . --json --view storage --output batho_export.json

# Query node-level evolution history or run diffs
batho diff --root . --run <run-id>

# Run integrity check and auto-repair on database
batho fix --root . --dry-run

# Run garbage collection and sweep old runs
batho gc --root . status

# Unpack transport zip bundle (.batho) into artifact directory
batho load path/to/artifact.batho

# Show all commands
batho --help

Batho scans your codebase, extracts every function, class, import, and relationship, and writes structured output to .batho/.

Next Steps​