Guides
Practical walkthroughs of every part of Shep.
Working with features
| Guide | Read it for |
|---|---|
| Your First Feature | A walkthrough from repo to merged PR. |
| Spec-Driven Mode | Optional requirements and planning phases with approval gates. |
| CI Watch & Auto-Fix | What happens after the PR opens and CI runs. |
| Git checkpoints | Diff or roll back any step an agent took. |
| PR review comments | Let an agent address review comments on its PR. |
| Multi-Repo | Running features across many repos from one place. |
Interfaces
| Guide | Read it for |
|---|---|
| Web Dashboard | The Control Center, Chat, Agent activity, the feature drawer and settings. |
| Chat | Asking for work in a conversation, with inline specs, previews and plans. |
| Terminal console | shep tui and shep ps — every feature from the keyboard. |
| CLI Reference | Every command, grouped by area. |
Running at scale
| Guide | Read it for |
|---|---|
| Fleet management | Parallel limits, the queue, triage, bulk approve and retry. |
| Supervisor & guardrails | Policies and rules that approve or block gates for you. |
Apps
| Guide | Read it for |
|---|---|
| Start an app | Create a new app from a description, with starters. |
| Dev servers | How Shep finds and runs your app’s dev server. |
Agents & models
| Guide | Read it for |
|---|---|
| Agents | The 12 agents Shep can drive, how to sign them in and switch. |
| Models & effort | Default model, reasoning effort, adaptive tiers and shep usage. |
| Agent harness | Experimental: Shep’s own query-aware harness and self-learning. |
Integrations
| Guide | Read it for |
|---|---|
| MCP | Let Claude Code or another MCP client drive Shep. |
| A2A | The A2A endpoint, the agent activity API and Herdr. |
Configuration
| Guide | Read it for |
|---|---|
| Configuration | Where settings live, shep settings, environment variables. |
| Feature flags | What each flag turns on, and which are on by default. |
| Worktree provisioning | Custom commands to create or prepare each worktree. |
| Usage metrics & privacy | What Shep sends, what it never sends, and how to turn it off. |
Building a larger pipeline — repos grouped into spaces, Linear or Jira sync, incidents, opportunities? See the Software factory section.
What’s next
- Your First Feature — the best place to start if you haven’t run a feature yet.
- Core Concepts — the worktree model and lifecycle before you dive deep.
- Troubleshooting — common setup issues and how to fix them.