shipper ship
shipper ship
Section titled “shipper ship”Usage: shipper ship [options] [issue]
Run the full workflow end-to-end
Arguments
Section titled “Arguments”| Argument | Required | Description | Choices |
|---|---|---|---|
| [issue] | no | issue number | - |
| Long | Short | Value | Default | Description | Choices |
|---|---|---|---|---|---|
| —merge | - | - | false | auto-merge the PR after reaching shipper:ready | - |
| —auto | - | - | false | run autonomous continuous shipping loop | - |
| —parallel | - | - | number of parallel slots (requires —auto) | - | |
| —mode | - | default | execution mode: headless, interactive, or default | headless, interactive, default | |
| —agent | - | - | agent to use: claude, codex, copilot, or opencode | claude, 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 | - |
Examples
Section titled “Examples”Run issue 42 through the workflow and merge it.
shipper ship 42 --mergeRun the autonomous shipping loop with three parallel slots.
shipper ship --auto --parallel 3Exit Codes
Section titled “Exit Codes”| Code | When |
|---|---|
| 0 | The issue or auto run completes without a terminal failure. |
| 1 | Preflight, validation, stage execution, merge, or auto-ship execution fails. |
| 75 | A single-issue ship run pauses because the pause sentinel is present. |
| 76 | A single-issue ship run encounters a retriable failure. |
Constraints
Section titled “Constraints”- —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