Introduction

Shipper is a workflow orchestrator for GitHub-hosted repositories. It is not a coding agent. It keeps a GitHub issue moving through product grooming, design, planning, implementation, PR review, remediation, and merge while the configured agent does the stage work.

The workflow state lives in GitHub labels, not in a local database. Issue bodies and comments carry the stage artifacts: grooming summaries, technical designs, implementation plans, review output, and implementation summaries. Shipper reads the current label, chooses the next command, creates the work context, and expects the agent to report a verdict through the stage contract.

You can run Shipper through the npm CLI or the supported macOS desktop app. Both entry points use the same GitHub labels, issues, comments, locks, settings, and workflow artifacts, so teams can move between terminal workflows and the desktop pipeline board without changing project state.

Start with Getting Started for CLI setup or the Desktop guide for desktop setup. Read Architecture for the runtime tour, State Machine for label behavior, and Protocol for the agent contract.