Agentra LabsAgentra Labs DocsPublic Documentation
WebsiteGitHub

AgenticCodebase

Command Surface

Install commands are documented in Installation.

Install commands are documented in Installation.

Binaries

  • acb (CLI compiler and query engine)
  • acb-mcp (MCP server)

acb top-level

acb compile
acb info
acb query
acb get
acb completions
acb health
acb gate
acb budget

acb compile

acb compile <repo-path> -o graph.acb
acb compile <repo-path> --exclude "target" --exclude "node_modules"
acb compile <repo-path> --coverage-report coverage.json

Common options:

  • --output <file.acb>
  • --exclude <glob> (repeatable)
  • --include-tests
  • --coverage-report <path>

acb query types

acb query <file.acb> symbol
acb query <file.acb> deps
acb query <file.acb> rdeps
acb query <file.acb> impact
acb query <file.acb> calls
acb query <file.acb> similar
acb query <file.acb> prophecy
acb query <file.acb> stability
acb query <file.acb> coupling
acb query <file.acb> test-gap
acb query <file.acb> hotspots
acb query <file.acb> dead-code

acb health

acb health <file.acb>
acb health <file.acb> --limit 20 --format json

Returns graph-wide risk, test gaps, hotspots, and dead-code summary.

acb gate

acb gate <file.acb> --unit-id 42
acb gate <file.acb> --unit-id 42 --max-risk 0.55 --depth 4 --require-tests

Fails with non-zero exit if risk/test criteria are not met (CI-friendly).

acb budget

acb budget <file.acb>
acb budget <file.acb> --horizon-years 20 --max-bytes 2147483648
acb budget <file.acb> --format json

Estimates long-horizon growth and reports whether the graph is on track for a fixed storage budget.

Runtime policy env:

export ACB_STORAGE_BUDGET_MODE=auto-rollup
export ACB_STORAGE_BUDGET_BYTES=2147483648
export ACB_STORAGE_BUDGET_HORIZON_YEARS=20
export ACB_STORAGE_BUDGET_TARGET_FRACTION=0.85

acb-mcp

acb-mcp serve

Common options:

  • --config <toml>
  • --graph <file.acb>
  • --name <graph-name>

Universal MCP entry

{
  "mcpServers": {
    "agentic-codebase": {
      "command": "$HOME/.local/bin/acb-mcp",
      "args": []
    }
  }
}