Ship code with oneshot CLI. One command that plans, executes, reviews, and opens a PR. Runs over SSH or locally. Use when the user wants to ship code changes, automate PRs, or run a coding pipeline with Claude and Codex.
Ship code with a single command. oneshot runs a full pipeline: plan (Claude) → execute (Codex) → review (Codex) → PR (Claude). Works over SSH to a remote server or locally with --local.
bun install -g oneshot-ship
Run oneshot init to configure SSH host, workspace path, API keys, and model preferences. Config is saved to ~/.oneshot/config.json.
Repos on the server should live as <org>/<repo> under the workspace path:
~/projects/
my-org/my-app/
my-org/my-api/
ANTHROPIC_API_KEY and OPENAI_API_KEY in environmentoneshot <repo> "<task>" # ship a task
oneshot <repo> <linear-url> # ship from a Linear ticket
oneshot <repo> "<task>" --bg # fire and forget
oneshot <repo> "<task>" --local # run locally, no SSH
oneshot <repo> "<task>" --deep-review # force exhaustive review
oneshot <repo> "<task>" --model sonnet # override Claude model
oneshot <repo> "<task>" --branch dev # target a different branch
oneshot <repo> --dry-run # validate only
oneshot init # configure
oneshot stats # recent runs + timing
fast or deep via heuristics + LLMdeep mode it runs an exhaustive review across correctness, security, and code qualityWorktree is cleaned up after every run.
~/.oneshot/config.json:
{
"host": "[email protected]",
"basePath": "~/projects",
"anthropicApiKey": "sk-ant-...",
"linearApiKey": "lin_api_...",
"claude": { "model": "opus", "timeoutMinutes": 180 },
"codex": {
"model": "gpt-5.4-mini",
"reasoningEffort": "xhigh",
"reviewModel": "gpt-5.4-mini",
"reviewReasoningEffort": "xhigh",
"timeoutMinutes": 180
},
"stepTimeouts": {
"planMinutes": 20,
"executeMinutes": 60,
"reviewMinutes": 20,
"deepReviewMinutes": 20,
"prMinutes": 20
}
}
Only host is required for SSH runs. Local mode works without a config file.
| Flag | Short | Description |
|---|---|---|
--model | -m | Override Claude model |
--branch | -b | Base branch (default: main) |
--deep-review | Force exhaustive review mode | |
--local | Run locally instead of over SSH | |
--bg | Run in background, return PID + log path | |
--dry-run | -d | Validate only |
--events-file | Mirror JSONL events to an additional file | |
--help | -h | Help |
--version | -v | Version |
CLAUDE.md in any repo root. oneshot passes it to Claude and Codex at every stepprompts/plan.txt, execute.txt, review.txt, pr.txt to change pipeline behavior--bg to fire and forget long tasksfast or deep mode automatically. Use --deep-review to force deep~/.oneshot/history.json)