cli reference

pipemason cancel

Stop a run cleanly. Idempotent: cancelling an already-cancelled or completed run returns the current state without erroring.

Usage

pipemason cancel <run-id>

What happens

The runner sends a cancel signal through the run's Durable Object. The agent receives an abort control message at its next cooperative checkpoint and exits cleanly. The DB row is set to status: cancelled with a final iterations.log entry. The branch is left in place for inspection — nothing is force-deleted or force-pushed.

Note

For programs, use pipemason program cancel <program-id> to stop dispatching new stories. In-flight stories complete or escalate normally.

Exit codes

0      cancel acknowledged (or run already terminal)
1      run not found
2      runner config / pairing problem
3      remote API error / network