Welcome to Shep
Run a fleet of coding agents. Merge real PRs.
Shep runs AI coding agents in parallel, each in its own git worktree, so you can work on ten features at once without them touching each other or your checkout. Shep handles the branches, commits, pushes, pull requests and CI watching around each agent. You decide how much of that is automatic.

Quick start
npx @shepai/cli # try it without installing
npm i -g @shepai/cli # or install globally
cd your-project
shep # starts Shep and opens localhost:4050 in your browser
shep feat new "add a /health endpoint" --push --prThe first time you open Shep, the browser walks you through setup: pick an agent, pick a model, and Shep checks that the agent is installed and signed in.
The last command creates a worktree, runs your agent there, commits, pushes and opens a draft PR. You keep working on main.
Prefer zero install? app.shep.bot runs Shep in your browser.
Where to start
| If you want to… | Read this |
|---|---|
| Install Shep and open your first PR | Getting Started |
| Learn by doing, one task at a time | Tutorials |
| Understand worktrees and parallel runs | How Shep Works |
| Manage features from the browser | Web Dashboard |
| Stay in the terminal | Terminal console |
| Ask for work in a conversation | Chat |
| Run many features and keep the queue moving | Fleet management |
| Start a new app from a description | Start an app |
| Choose from 12 agents and their models | Agents · Models & effort |
| Look up a CLI command or flag | CLI Reference |
| Change settings and defaults | Configuration |
| Watch CI and auto-fix failures | CI Watch & Auto-Fix |
| Add requirements and planning gates | Spec-Driven Mode |
| Understand the spec-first, YAML-based way Shep works | The AI-Native SDLC |
| Look up every field of the spec YAML files | Spec File Schemas |
| Connect other tools (MCP, A2A) | MCP · A2A |
| Group repos, trackers and incidents | Software factory |
| Know what Shep sends about usage | Usage metrics & privacy |
| Solve a setup or runtime issue | Troubleshooting |
Who is Shep for?
Engineers who already use AI coding agents and want to run more than one feature at a time without losing track. You’re ready if you have Node.js 22+, Git, an authenticated GitHub CLI (gh), and one of these agent CLIs signed in: claude, kimi, codex, copilot, cursor-agent, gemini or cline. No CLI? OpenRouter and Together AI work with an API key, Ollama and an LLM proxy run locally, and the Demo agent needs nothing at all.
Stay in the loop
- Star the GitHub repo
- Join the Discord — questions, bug reports, feature requests
- @shepai_bot on X
What’s next
- Getting Started — install Shep and open your first PR in five minutes.
- Tutorials — step-by-step: your first merged PR, ten features at once, gates and checkpoints, tmux, apps.
- How Shep Works — the worktree model in plain English.
- Web Dashboard — the pages, panels and shortcuts of the web UI.