Skip to Content
Welcome

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.

The Shep Control Center: the session tree lists four features of the acme-store repository; on the canvas the repository node branches to four feature cards in different states (Review Technical Plan, Review Requirements, Completed, Implementing); the fleet status bar reads 1 cruising, 0 queued, 3 need you, 0 failed, Triage (3)

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 --pr

The 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 PRGetting Started
Learn by doing, one task at a timeTutorials
Understand worktrees and parallel runsHow Shep Works
Manage features from the browserWeb Dashboard
Stay in the terminalTerminal console
Ask for work in a conversationChat
Run many features and keep the queue movingFleet management
Start a new app from a descriptionStart an app
Choose from 12 agents and their modelsAgents · Models & effort
Look up a CLI command or flagCLI Reference
Change settings and defaultsConfiguration
Watch CI and auto-fix failuresCI Watch & Auto-Fix
Add requirements and planning gatesSpec-Driven Mode
Understand the spec-first, YAML-based way Shep worksThe AI-Native SDLC
Look up every field of the spec YAML filesSpec File Schemas
Connect other tools (MCP, A2A)MCP · A2A
Group repos, trackers and incidentsSoftware factory
Know what Shep sends about usageUsage metrics & privacy
Solve a setup or runtime issueTroubleshooting

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

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.