CLI Reference

# Show all commands
batho --help

# Show command-specific help
batho <command> --help

Command Matrix

Command	Purpose
build	Build a complete code graph, BSG map, and baseline snapshot for a repository.
patch	Detect changes natively and apply incremental updates to an existing database.
export	Export BSG artifacts as JSON views or package them into a transport ZIP bundle.
load	Unpack a transport ZIP bundle (.batho file) into the target repository's artifact directory.
fix	Verify structural consistency and automatically repair database integrity issues.
diff	Track granular node evolution and print node-level diff history across runs, files, or entities.
gc	Clean up old runs, sweep orphaned files, and vacuum the Arrow IPC database.
mcp	Start the Batho MCP server for AI agent integration.

Global CLI Flags

The following flags are shared across all batho subcommands:

Flag	Default	Description
--root PATH	.	Repository root directory to scan or target.
--verbose	false	Enable verbose debug logging to standard error.
-h, --help	-	Show the help message for batho or a specific subcommand.