shipper new
shipper new
Section titled “shipper new”Usage: shipper new [options] [request…]
Create a new issue interactively or from a request
Arguments
Section titled “Arguments”| Argument | Required | Description | Choices |
|---|---|---|---|
| [request…] | no | your idea for the new issue | - |
| Long | Short | Value | Default | Description | Choices |
|---|---|---|---|---|---|
| —log-file | - | - | write agent output to a specific log file | - | |
| —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”Ask Shipper to draft a new issue from a request.
shipper new Add a CLI flag for stale lock cleanupExit Codes
Section titled “Exit Codes”| Code | When |
|---|---|
| 0 | Shipper creates the issue from a validated agent draft. |
| 1 | Preflight, draft validation, GitHub issue creation, worktree setup, hooks, or agent execution fails. |
Constraints
Section titled “Constraints”- —disable-mcp and —enable-mcp are mutually exclusive