Quick Start

Prerequisites

Requirement	Version	Install
tmux	3.2+	`brew install tmux`
jq	any	`brew install jq`
Claude Code CLI	latest	`npm install -g @anthropic-ai/claude-code`
Node.js	20+	For hooks
Git	any	For installation

Interactive installer that sets up tmux config, Claude Code settings, hooks, and the shipwright CLI:

git clone https://github.com/sethdford/shipwright.git
cd shipwright
./install.sh

One-command setup with no prompts — installs just the tmux configuration:

git clone https://github.com/sethdford/shipwright.git
cd shipwright
./scripts/sw-init.sh

Start tmux
Terminal window
```
tmux new -s dev
```
Launch a team session with a template
Terminal window
```
shipwright session my-feature --template feature-dev
```
This creates a 3-agent team (backend, frontend, tests) with the leader pane taking 65% of the screen.
Start coding with Claude
Terminal window
```
claude
```
Tell Claude what you want to build. It will coordinate the agents across tmux panes.

Monitor your team

shipwright status      # Team dashboard
shipwright ps          # Running agent processes

Or press Ctrl-a then Ctrl-t for an inline dashboard.

Run the built-in doctor to check everything is configured correctly:

shipwright doctor

This checks tmux version, jq availability, overlay hooks, color configuration, and orphaned sessions.