Shepherd

Shepherd

AI coding orchestration platform that manages a flock of AI coding agents across many projects — like a shepherd tending a flock.

한국어 문서는 [README_KO.md](README_KO.md)를 참고하세요.

Overview

Shepherd runs multiple AI coding agents ("sheep") in parallel across different codebases, routes tasks to the right worker, streams their live output, and keeps a full task history. It is built around a **Web UI + daemon** and speaks to a wide range of AI backends — cloud CLIs, self-hosted local models, and a built-in multi-model consensus engine (MAGI).


Three ways to drive it:

• Web UI (primary) — Full dashboard with real-time streaming, task management, project git views, file browser, issues, wiki, schedules, and skills
• MCP Server — Integrate with Claude Desktop / other MCP clients
• CLI — Direct commands and a legacy interactive/TUI mode

Core Concepts

• Shepherd (Manager) — Analyzes each task and routes it to the right worker
• Sheep (Workers) — Individual AI agent instances, each assigned to a project and a provider
• Projects — Codebases the sheep work on
• Providers — The AI backend a sheep uses (Claude, OpenCode, Pi, Grok, Embedded, MAGI)
• Sheep Personal Memory — Per-sheep notes under ~/.shepherd/sheep// that follow the sheep across projects (moments, bonds, voice)

Providers

Shepherd is multi-provider. Each sheep runs one provider; you can mix providers across your flock and switch per sheep at any time.

Provider	Backend	Auth / Setup	Best for
claude	Claude Code CLI	CLI handles its own login	Default — code writing, complex agentic tasks
opencode	OpenCode CLI	CLI config	Reviews, web search, cheaper/local models
pi	Pi coding agent CLI (pi --print --mode json)	CLI config	Claude-class general coding harness
grok	Grok / xAI CLI (`grok --output-format stre