Skip to Content
Welcome

Welcome to Shep

Shep runs AI coding agents in parallel — each in its own git worktree — so you can ship 10+ features at once. One command and your agent codes, commits, pushes, and opens a pull request. You stay on main the entire time.

Shep dashboard with three features running in parallel

Quick start

npx @shepai/cli                     # try it without installing
npm i -g @shepai/cli                # or install globally
 
cd your-project
shep                                # opens dashboard at localhost:4050
 
shep feat new "add a /health endpoint" --push --pr

That last command creates a worktree, runs your AI agent, commits, pushes, and opens a PR — all while you keep coding on main.

Where to start

If you want to…Read this
Install Shep and ship your first PRGetting Started
Understand worktrees and parallel runsHow Shep Works
Manage features from the browserWeb Dashboard
Look up a CLI flag or commandCLI Reference
Customize agent, port, or workflowConfiguration
Watch CI and auto-fix failuresCI Watch & Auto-Fix
Add structure with approval gatesSpec-Driven Mode
Work across multiple repos at onceMulti-Repo
Switch between Claude / Cursor / GeminiCustom Agents
Solve a setup or runtime issueTroubleshooting

Who is Shep for?

Engineers already using AI coding agents who want to run more than one feature at a time without losing track. If claude, cursor, or gemini is on your PATH and you have GitHub CLI configured, you’re ready.

Stay in the loop

Getting Started