shep-ai/shep

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/shep-logo-dark.png"> <source media="(prefers-color-scheme: light)" srcset="docs/screenshots/shep-logo-light.png"> <img src="docs/screenshots/shep-logo-light.png" alt="Shep logo" width="72"> </picture>

Run a fleet of coding agents. Merge real PRs.

<img src="docs/screenshots/demo.gif" alt="Shep spinning up parallel agents in isolated git worktrees and opening a pull request" width="900"> </div>

Shep is the open-source orchestrator for the autonomous development cycle. It runs parallel AI agents — Claude Code, Cursor CLI, Gemini CLI, or any agent CLI — each in its own isolated git worktree, and drives every feature from a one-line description through optional spec gates, implementation, commit, push, CI watching with auto-fix, and a draft pull request. Agent-agnostic, local-first, MIT-licensed.

Quickstart

npx @shepai/cli        # try it instantly — opens the dashboard at localhost:4050
npm i -g @shepai/cli   # or install globally

Three commands from zero to an open pull request:

npm i -g @shepai/cli
cd ~/projects/my-app
shep feat new "add a /health endpoint that returns uptime and version" --push --pr

Shep creates a worktree, runs your agent, commits, pushes, and opens a PR. Requires Node.js 22+, Git, the GitHub CLI (gh), and an authenticated agent CLI (claude, cursor, or gemini). Prefer zero install? [app.shep.bot](