Skip to content

CLI reference

Complete reference for all Pipemason CLI commands. The pipemason binary runs locally on your machine and drives the pipeline against the current git repository.

Synopsis

pipemason <command> [arguments] [flags]

Run any command from inside a git repository. The first command you should run on a new machine is pipemason login, which pairs the machine to your account.

Commands

  • pipemason login — pair this machine to your Pipemason account via a device-code flow. See login.
  • pipemason start — start a single-story run from a feature description (one story → one branch → one PR). See start.
  • pipemason program — start and manage multi-story programs that span whole systems. See program.
  • pipemason status — display the current status of a run by printing.pipeline/STATE.md. See status.
  • pipemason resume — resume a paused or escalated run after fixing the underlying issue. See resume.
  • pipemason cancel — cancel a run that is in progress. See cancel.
  • pipemason audit — snapshot an existing system before a brownfield program. See audit.
  • pipemason agent — runner/agent management subcommands. See agent.

Global flags

  • --max-tier <haiku|sonnet|opus|fable> — set the most expensive model tier the run is allowed to use. Applied as a per-run ceiling; the runner uses whichever ceiling is more restrictive between this flag and your configuration. fable is the top tier and is opt-in.
  • --version — print the installed CLI version.