Skip to content

CLI reference

The heal console script. This page is generated from the command app.

heal [COMMAND] [ARGS]...

heal apply

Apply recorded fix proposals (patch by default; --in-place opt-in).

Parameter Kind Description
TARGET argument RF output dir or events.jsonl
--in-place option Apply fixes to source files (clean git tree required)
--force option Apply in place even on a dirty git tree
--patch option Write the unified patch to this file

heal corpus

Harvest ground-truth eval fixtures from recorded healing runs.

Parameter Kind Description
PATHS argument Run stores or directories containing events.jsonl
--out option Fixture output directory (default: tests/evals/fixtures)

heal doctor

Probe the configured model endpoints and resolve capabilities.

Parameter Kind Description
--role option Agent role to probe (triage, locator, vision, rca or 'all') (default: locator)
--vision option Include the vision probe

heal history

Show maintenance hotspots (locators healed repeatedly).

Parameter Kind Description
DB argument Path to history.sqlite
--min-count option (default: 3)
--days option (default: 30)

heal mcp

Start the MCP server (stdio) over the run store and fix engine.

Parameter Kind Description
TARGET argument RF output dir or events.jsonl to expose (optional)

heal report

Render the HTML dashboard and summary.json from a run store.

Parameter Kind Description
TARGET argument RF output dir or events.jsonl
--out option Output directory (default: alongside the store)

heal triage

Summarize recorded failures: diagnoses, heals, RCAs, fix proposals.

Parameter Kind Description
TARGET argument RF output dir or events.jsonl