Usage

cd /path/to/your/project
 
# 1. Linear ticket (default)
boatman work ENG-123
 
# 2. Inline prompt
boatman work --prompt "Add a health check endpoint at /health"
 
# 3. File-based prompt
boatman work --file ./tasks/authentication.md
 
# With custom title and branch
boatman work --prompt "Add auth" --title "Authentication" --branch-name "feature/auth"

boatman work ENG-123 --max-iterations 5        # More refactor attempts
boatman work ENG-123 --base-branch develop     # Different base branch
boatman work ENG-123 --dry-run                 # Preview without changes
boatman work ENG-123 --review-skill my-review  # Use custom review skill

boatman watch

tmux attach -t boatman-executor
tmux attach -t boatman-reviewer-1
tmux attach -t boatman-planner

Claude is working (with file write permissions)...
Activity will stream below:

Running: ls -la src/
Reading: src/api/handlers/users.go
Editing: src/api/handlers/auth.go
Writing: src/api/handlers/auth_test.go
Searching files...

Task completed!

boatman sessions list       # List active sessions
boatman sessions kill       # Kill all boatman sessions
boatman sessions kill -f    # Also kill orphaned claude processes
boatman sessions cleanup    # Clean up idle sessions

boatman worktree list                    # List all worktrees
boatman worktree commit                  # Commit changes (WIP)
boatman worktree commit wt-name "msg"    # Commit with message
boatman worktree push                    # Push branch to origin
boatman worktree clean                   # Remove all worktrees

# Navigate to the worktree
cd .worktrees/philmiddleton-eng-123-feature
 
# Inspect changes
git status
git diff
 
# Commit and push
git add -A
git commit -m "feat: implement feature"
git push -u origin HEAD

# Resume an interrupted workflow
boatman work ENG-123 --resume
 
# View checkpoint history
git log --oneline --grep "\[checkpoint\]"
 
# Create a snapshot branch
boatman checkpoint snapshot "before-refactor"
 
# Squash checkpoint commits before PR
boatman checkpoint squash "feat: implement feature ENG-123"

# Undo last refactor attempt
git reset --hard HEAD~1
 
# Go back to before review started
boatman checkpoint rollback --step execution
 
# Restore from snapshot branch
git checkout checkpoint/ENG-123/before-review -- .

export BOATMAN_DEBUG=1
boatman work ENG-123