Skip to content

Cost control

Pipemason gives you two ceilings — cumulative and per-day — so a program can never spend more than you expect. Set them when you start a program and the runner enforces them automatically.

Cumulative ceiling

Cap the total spend for an entire program with --max-cost. Once a program's accumulated cost reaches this ceiling, it pauses rather than spending past it:

pipemason program start "build a Linear-style issue tracker" \
  --mode greenfield-system \
  --max-cost 50

The value is in US dollars and applies across the whole program run.

Per-day ceiling

Bound how much a program can spend in a single calendar day with --max-daily-cost. This is useful for long programs you want to spread out:

pipemason program start "..." --mode greenfield-system \
  --max-daily-cost 40
  • There is no per-day ceiling unless you pass one; 0 also means off.
  • The daily counter resets at midnight UTC.

Tip

When a program hits its per-day ceiling, auto-advance pauses for the day and resumes automatically the next day — you don't have to restart it manually.

Combining ceilings

These ceilings stack. A common setup caps total spend and bounds the per-day rate at once:

pipemason program start "migrate auth to passkeys" \
  --mode brownfield-upgrade \
  --max-cost 75 \
  --max-daily-cost 25

With this configuration the program never exceeds $75 total and never spends more than $25 in a day (resuming the next day when it hits that).