agurrrrr

Shepherd — AI skill for Claude Code

AI community

AI coding orchestration CLI that manages multiple Claude Code sessions — like a shepherd tending a flock.

How to install Shepherd

This entry records only its repository, not the path inside it, so there is no exact command to give. Open agurrrrr/shepherd and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Shepherd does

AI coding orchestration CLI that manages multiple Claude Code sessions — like a shepherd tending a flock. Run dozens of AI agents across different projects simultaneously via CLI, Web UI, or MCP.

Alternatives in AI

Claude Squad — by smtg-ai - Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents i 6.5k ★
Installation Guide - Claude Skills Library — Complete installation guide for all 170 production-ready skills across multiple AI agents and platforms 5.3k ★
Omnara — by Ishaan Sehgal - A command center for AI agents that syncs Claude Code sessions across terminal, web, and mo 2.6k ★

README

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).

![Shepherd Dashboard](assets/webui-dashboard.png)

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