![\"AutoShip](\"assets/autoship-banner.svg\")
\n\n \n
\n ![\"Stars\"](\"https://img.shields.io/github/stars/Maleick/AutoShip?style=flat&color=f59e0b\")
![\"Last](\"https://img.shields.io/github/last-commit/Maleick/AutoShip?style=flat\")
![\"Version\"](\"https://img.shields.io/github/v/release/Maleick/AutoShip?style=flat\")
![\"License\"](\"https://img.shields.io/github/license/Maleick/AutoShip?style=flat\")
![\"Docs\"](\"https://img.shields.io/badge/docs-autoship.teamoperator.red-blue?style=flat\"){kind=icon}
![\"Sponsor\"](\"https://img.shields.io/github/sponsors/Maleick?label=Sponsor&logo=GitHub&color=EA4AAA&style=flat\")
\n Install •\n Docs •\n Wiki •\n Commands •\n Runtime •\n Testing •\n Sponsor\n
\n\nTurn backlog into reviewed PRs.
\n\nAutoShip is the multi-runtime plugin for solo maintainers who want their GitHub issue queue planned, routed, verified, and packaged into pull requests without babysitting every worker.\n\n```text\n┌──────────────────────────────────────────┐\n│ ISSUE PLANNING CONFIGURED ROLE │\n│ MODEL SELECTION LIVE OPENCODE │\n│ WORKER DISPATCH 15 ACTIVE MAX │\n│ REVIEW CONFIGURED ROLE │\n│ PR CREATION CONVENTIONAL │\n├──────────────────────────────────────────┤\n│ HERMES RUNTIME 3 ACTIVE MAX │\n│ CRON DISPATCH AUTONOMOUS │\n│ SUBAGENT POOL PARALLEL │\n└──────────────────────────────────────────┘\n```\n\n## What It Does\n\n- Reads open GitHub issues labeled `agent:ready` (OpenCode) or `autoship:ready-simple` (Hermes)\n- Plans work in ascending issue-number order\n- Dispatches **OpenCode** workers up to 20 concurrent\n- Dispatches **Hermes** workers up to 20 concurrent via cronjobs\n- Verifies completed work before PR creation\n- Creates PRs with conventional commit titles\n- Tracks local state in `.autoship/`\n\n## Installation\n\nTo have OpenCode fetch install instructions directly, tell OpenCode:\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/Maleick/AutoShip/refs/tags/v2.2.1/INSTALL.md\n```\n\nInstall the CLI globally if you want AutoShip available long-term on your PATH:\n\n```bash\nnpm install -g opencode-autoship\nopencode-autoship install\nopencode-autoship doctor\n```\n\nFor a one-time install without keeping a global CLI, use `bunx` instead:\n\n```bash\nbunx opencode-autoship install\nbunx opencode-autoship doctor\n```\n\nThen start the setup wizard inside OpenCode:\n\n```text\n/autoship-setup\n```\n\nSee [`INSTALL.md`](INSTALL.md) for prerequisites, verification, updating, and troubleshooting.\n\n## Quick Start\n\n```bash\n# 1. Install the CLI globally\nnpm install -g opencode-autoship\n\n# 2. Install AutoShip for OpenCode\nopencode-autoship install\nopencode-autoship doctor\n\n# 3. Navigate to your project\ncd ~/Projects/my-project\n\n# 4. Configure the target repo in OpenCode\n/autoship-setup\n\n# 5. Start AutoShip in OpenCode\n/autoship\n```\n\n## Runtime\n\nAutoShip supports **two worker runtimes**:\n\n### OpenCode (Primary)\nOpenCode is the primary supported worker runtime. AutoShip discovers current model availability from:\n\n```bash\nopencode models\n```\n\nSetup defaults to ranked free worker models from the current OpenCode inventory. On first run, the setup wizard asks which models to use for the orchestrator and reviewer roles; these can be the same model or different models. Operators can explicitly select a comma-separated worker model list with `AUTOSHIP_MODELS`.\n\nThe selected routing is saved to `.autoship/model-routing.json`. Edit that file manually to tune model eligibility, strength, or task types. Setup preserves manual edits by default; use `AUTOSHIP_REFRESH_MODELS=1 bash hooks/opencode/setup.sh` to regenerate from the current OpenCode inventory.\n\n### Hermes (Secondary)\nHermes is supported as an alternative runtime for autonomous cron-based burn-down. Hermes uses the provider and model configured in `~/.hermes/config.yaml` and dispatches work via `cronjob` or `delegate_task`.\n\n```bash\n# Setup Hermes runtime\nbash hooks/hermes/setup.sh\n\n# Plan issues for Hermes\nbash hooks/hermes/plan-issues.sh\n\n# Dispatch an issue to Hermes\nbash hooks/hermes/dispatch.sh