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 | - | |
| —accept-rewritten-base | - | recorded:incoming | - | accept a base-branch rewrite previously previewed by this command | - |
| —mode | - | default | execution mode: headless, interactive, or default | headless, interactive, default | |
| —agent | - | - | agent to use: claude, codex, copilot, grok, or opencode | claude, codex, copilot, grok, opencode | |
| —model | - | - | model to use for the agent CLI | - | |
| —reasoning-effort | - | - | reasoning effort to pass to 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
- The validated draft is written to the local issue-state store before Shipper creates the GitHub mirror.
- The local store keeps the full issue body; GitHub receives the size-fitted mirror copy when needed.
assignMirroredIssuesToSelfdefaults to false and follows ordinary user-global, repository, and personal precedence. When enabled in mirror-on mode, Shipper additively assigns the current GitHub account to the newly created intake mirror without replacing existing assignees.- Assignment is best-effort and write-once: failure returns an issue-specific warning without failing issue creation, store-only mode performs no assignment, and later commands or reconcile runs do not maintain or retry the assignee.
- Troubleshooting: local issue-state content or mirror drift
- On macOS, New is qualifying progress-capable work and automatically prevents idle system sleep. See Keep the Mac awake during active work.