CLI reference

repairledger [--cwd PATH] [--json] [--version] COMMAND

Global options

Option	Description
`--cwd PATH`	Current working directory (invocation context only).
`--json`	Output JSON envelopes.
`--version`	Show version and exit.

--root PATH is accepted for backward compatibility but is deprecated: Repairledger has no workspace root. The value only affects the Workspace.root field of internal data classes.

Initialization

repairledger init
repairledger init --data-path /custom/path
repairledger init --config-path /custom/path/rl.toml

Option	Description
`--data-path PATH`	Absolute or `~`-expanded data path.
`--config-path PATH`	Absolute custom global config file.
`--repairledger-dir`	Deprecated alias for `--data-path`.
`--project-name`	Deprecated; ignored (no project section).
`--hidden-config`	Rejected (`unsupported_local_config`).

Project commands

Command	Description
`init`	Initialize the user-global config and data path.
`status`	Show Repairledger status. Read-only.
`info`	Show Repairledger config or repair info.
`doctor`	Run Repairledger diagnostics. Read-only.
`next-action [REPAIR_ID]`	Show the next recommended action.
`log`	Convenience repair logging command.

Repair commands

Command	Description
`repair activate REPAIR_ID`	Set a repair as active.
`repair list`	List repairs with optional filters.
`repair show [REPAIR_ID]`	Show a repair observation.
`repair status [REPAIR_ID] STATUS`	Change repair status. Requires `--repair` when >1 repairs exist.
`repair archive [REPAIR_ID]`	Archive a repair. Requires `--repair` when >1 repairs exist.
`repair build [REPAIR_ID]`	Build rendered artifacts. Requires `--repair` when >1 repairs exist.
`repair export [REPAIR_ID]`	Export repair Markdown to global `exports/`.
`repair validate [REPAIR_ID]`	Validate a repair.
`repair versions [REPAIR_ID]`	List versions.
`repair diff [REPAIR_ID]`	Diff two versions.
`repair apply --file PATH`	Apply structured JSON bundle.

Component commands

Command	Description
`repair component list [REPAIR_ID]`	List components.
`repair component show KEY`	Show a component.
`repair component set KEY`	Set a component. Requires `--repair` when >1 repairs exist.
`repair component append KEY`	Append to a component. Requires `--repair` when >1 repairs exist.

Report commands

Command	Description
`report build`	Build aggregate report to global `reports/`.
`report export`	Export aggregate report to global `exports/`.

Environment variables

Variable	Effect
`REPAIRLEDGER_CONFIG`	Absolute path to a custom config file.
`XDG_CONFIG_HOME`	Overrides the base directory for the config file.
`XDG_DATA_HOME`	Overrides the base directory for the data path.
`HOME`	Used as the fallback for `~` expansion.