cli reference

CLI reference

Every pipemason command, grouped by what you'd use it for. Each command page has the full flag list, examples, and what it writes to .pipeline/.

Identity + repo setup

Command	What it does
`pipemason login`	Pair this machine to your account (one-time per machine).
`pipemason init`	Scaffold .pipeline/ in the current repo. Detects domains.
`pipemason update`	Update the runner binary in place.
`pipemason verify`	Self-check: pairing valid, network reachable, model key set.

Running work

Command	What it does
`pipemason start "..."`	Start a single-story run. One feature → one branch → one PR.
`pipemason program start "..."`	Start a multi-story program with a planned DAG.
`pipemason cost-estimate "..."`	Dry-run planning; estimate total token spend.

Inspecting + managing runs

Command	What it does
`pipemason status`	Print live state for the current run / program.
`pipemason resume <id>`	Resume an escalated run after editing the failing artifact.
`pipemason cancel <id>`	Stop a run; idempotent. Branch is preserved for inspection.
`pipemason report`	Generate a markdown report for a completed run / program.
`pipemason screenshot`	Capture a screenshot of the dashboard for a run (for PR comments / docs).

Audit + agents

Command	What it does
`pipemason audit`	Inspect logs and replay phases locally without remote dispatch.
`pipemason agent ...`	Install / list / remove community agents.