Shep: запуск параллельных AI-агентов в git-репозиториях
Shep — инструмент для ускорения разработки, который запускает параллельные агенты">AI-агенты в изолированных git-рабочих деревьях. Это позволяет за одну строку описать новую фичу, выполнить её реализацию, сделать commit и открыть pull request, что значительно ускоряет процесс.
Проект может быть полезен разработчикам, которые хотят автоматизировать рутинные задачи при добавлении новых функций, минимизируя время на ручные операции. В отличие от стандартных CI/CD решений, Shep фокусируется на интеграции AI-агентов, что позволяет использовать их навыки для улучшения кода и автоматического тестирования, обеспечивая более гибкий подход к управлению проектом.
Для запуска требуется Node.js версии 22+, Git и GitHub CLI. Установить Shep можно через npm: npm i -g @shepai/cli, а для быстрого тестирования достаточно выполнить npx @shepai/cli. Учти, что проект находится на ранней стадии, и возможны баги.
Shep — это открытый оркестратор для автономного цикла разработки. Он запускает параллельные AI-агенты — Claude Code, Cursor CLI, Gemini CLI или любой другой агент CLI — каждый из них работает в своем собственном изолированном git worktree. Shep управляет всеми процессами, начиная с описания задачи и заканчивая автоматическим созданием чернового pull request. Это средство не привязано к конкретному агенту, работает локально и имеет лицензию MIT.
Быстрый старт
Чтобы начать работу, просто выполни следующую команду:
npx @shepai/cli # мгновенное использование — открывает панель управления по адресу localhost:4050
npm i -g @shepai/cli # или установи глобально
Три команды от нуля до открытия 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 создаёт worktree, запускает твой агент, коммитит, пушит и открывает PR. Требуется Node.js версии 22 и выше, Git, GitHub CLI (`gh`) и аутентифицированный агент CLI (`claude`, `cursor` или `gemini`). Если предпочитаешь использовать без установки, попробуй [app.shep.bot](https://app.shep.bot), это запустит Shep в твоём браузере, бесплатно.
Затем можно работать параллельно:
shep feat new "add stripe payments" --push --pr
shep feat new "add dark mode toggle" --push --pr
shep feat new "fix login redirect bug" --push --pr
Три агента, три worktree, никаких конфликтов в ветках — всё мониторится из одного места. Один сеанс агента — нормально; пять — это хаос. Shep позволяет избежать хаоса.
Как это работает
идея опциональные ворота спецификации параллельные агенты shep автоматизирует ты
"добавить платежи" → требования · план → каждый в своём → коммит · пуш · PR → проверка дельты,
(YAML, который ты подтверждаешь) git worktree CI отслеживание + автоисправление нажми на кнопку слияния
Основной процесс: от подсказки до реализации, коммита, пуша и PR. Твой рабочий каталог никогда не изменяется: каждая функция живёт в своём own worktree на своей ветке. Если CI падает, агент читает логи и пытается исправить ошибку (по умолчанию 3 попытки, это можно изменить). Для сложных функций добавь `--no-fast`, чтобы активировать полный специфицированный процесс разработки — требования, исследование и план, которые являются версионированными артефактами YAML, с воротами согласования перед написанием кода. Смотри [руководство по специфицированному развитию](./docs/development/spec-driven-workflow.md).
Поддерживаемые агенты
| Агент | Поддержка |
|---|---|
| Claude Code | Встроен |
| Cursor CLI | Встроен |
| Gemini CLI | Встроен |
| Любой терминальный агент CLI | Через общий исполнитель — если он запускается в терминале, Shep может им управлять. |
Заменяй агентов по функции, по репозиторию, в любое время. Нет привязки на уровне инструмента или модели.
Центр управления в вебе
Живой график всех репозиториев и функций по адресу `localhost:4050` — реальный статус, просмотр различий, интерактивный чат и одно нажатие для открытия в твоем IDE. Всё, что делает панель управления, CLI тоже может.
Конфигурация и справка
Shep предлагает различные флаги для настройки, которые позволяют задавать настройки по умолчанию и особенности для каждой функции:
| Флаг | Что делает | По умолчанию |
|---|---|---|
--push |
Авто-пуш после реализации | выключен |
--pr |
Автоматически создаёт PR после пуша | выключен |
--fast |
Пропустить этапы по спецификации, сразу писать код | включён |
--allow-merge |
Авто-слияние PR после прохода CI | выключен |
--model |
Выбрать, какой AI-модель использовать | по умолчанию для агента |
--repo |
Целевой конкретный репозиторий | текущий репозиторий |
Настройки можно задать один раз с помощью shep settings workflow, чтобы не повторять флаги. Полную справку можно найти в [документации по CLI](./docs/cli/architecture.md).
Открыть на GitHub: shep-ai/shep →
RepoRadar