Desktop App
The ShipCode desktop app is the primary way to run the pipeline. It’s an Electron + Vite + React 19 app built on top of the same packages/pipeline state machine that powers the CLI, with a rich UI for watching pipelines, triaging issues, scheduling automation, inspecting worktrees, editing settings, and reviewing plans and costs.
Install
brew tap shipshitdev/tap
brew install --cask shipcodeOr run from source:
bun install
bun run devSee Getting Started for prerequisites and first-pipeline walkthrough.
On first import of a GitHub-backed repository, ShipCode creates a small starter issue so the project has a safe first pipeline target immediately.
Layout
The app has a fixed left sidebar with projects, a top titlebar, a main content area, and a collapsible terminal drawer at the bottom. The sidebar contains shortcut entries to each of the global views:
| Section | What it does |
|---|---|
| Overview | Dashboard across all projects — running agents, pending approvals, recent work, time-to-PR analytics |
| Activity | Timeline of phase transitions, PRs, failures, automations, and notifications |
| Inbox | Triage queue for failed, verification-exhausted, and awaiting-approval threads |
| Costs | Per-thread and per-project token + USD aggregation |
| Automations | Cron-like scheduled prompts that launch pipeline runs for a project |
| Skills Editor | Edit the PRD / plan / review / verify prompt skills |
| Project detail | Issues, Git, Code, Pull Requests, Insights, and Terminal tabs for one project |
Per-project views
Inside a project, the main content area switches between:
| View | What it does |
|---|---|
| Issues / Kanban Board | Phase-column board plus dense list mode for dragging issues through the pipeline, running board review, and auto-running Backlog work |
| List view | Same data as Kanban, flattened into phase-grouped sections (toggle from the Kanban header) |
| Git | Worktree/branch visualizer, diff viewer, AI split auto-commit, cleanup |
| Code | Read-only source and worktree browser with syntax highlighting and diff mode |
| Pull Requests | Open/closed PR list with review status, checks, and detail panel |
| Insights | Project activity heatmap, tokens, spend, runs, and PR counts |
| Terminal | Project terminal tab plus bottom drawer for live agent output |
| Issue detail | Overlay that shows the full issue PRD, generated plan, review round history, diff, and full-screen Plan Viewer |
Settings
The Settings panel covers General, Integrations, GitHub, Notifications, Pipeline, Auto-commit, Shortcuts, Archived, Developer, and About. The per-project Project Settings modal covers repo setup, runtime QA, GitHub Projects sync, phase model overrides, pipeline behavior, memory/context generation, and chat routing.