Skip to content

shipper ship

Usage: shipper ship [options] [issue]

Run the full workflow end-to-end

ArgumentRequiredDescriptionChoices
[issue]noissue number-
LongShortValueDefaultDescriptionChoices
—merge--falseauto-merge the PR after reaching shipper:ready-
—auto--falserun autonomous continuous shipping loop-
—parallel--number of parallel slots (requires —auto)-
—mode-defaultexecution mode: headless, interactive, or defaultheadless, interactive, default
—agent--agent to use: claude, codex, copilot, or opencodeclaude, codex, copilot, opencode
—model--model to use for the agent CLI-
—disable-mcp---disable MCP server loading for this run-
—enable-mcp---enable MCP server loading for this run-

Run issue 42 through the workflow and merge it.

Terminal window
shipper ship 42 --merge

Run the autonomous shipping loop with three parallel slots.

Terminal window
shipper ship --auto --parallel 3
CodeWhen
0The issue or auto run completes without a terminal failure.
1Preflight, validation, stage execution, merge, or auto-ship execution fails.
75A single-issue ship run pauses because the pause sentinel is present.
76A single-issue ship run encounters a retriable failure.
  • —disable-mcp and —enable-mcp are mutually exclusive
  • —auto and an explicit issue argument are mutually exclusive
  • An issue argument is required unless —auto is used
  • —auto and —mode are mutually exclusive
  • —parallel requires —auto
  • —parallel must be a positive integer
  • Troubleshooting: failed issues and rollback loops
  • Troubleshooting: shipping and remediation exit codes