Shep CLI
Shep запускает кодинг-агентов параллельно, каждого в своем git worktree, и доводит задачу до черновика запроса на слияние
- 269 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- По умолчанию запускает агента с флагами обхода подтверждений, и тот выполняет команды и правит файлы без вопросов
- Сам пушит ветки и открывает запросы на слияние от вашего имени через GitHub CLI
- Отправляет метрики использования команде проекта, пока их не отключить
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/shepОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- По умолчанию запускает агента с флагами обхода подтверждений, и тот выполняет команды и правит файлы без вопросов
- Сам пушит ветки и открывает запросы на слияние от вашего имени через GitHub CLI
- Отправляет метрики использования команде проекта, пока их не отключить
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Shep ставится из npm как пакет `@shepai/cli` и управляет кодинг-агентами, которые уже стоят у вас: Claude Code, Kimi Code, Codex CLI, Copilot CLI, Cursor CLI, Gemini CLI или Cline. Для каждой задачи он создает отдельный git worktree на своей ветке, поэтому рабочая папка остается нетронутой, и три задачи не конфликтуют между собой. Задачу описывают одной строкой: `shep feat new "add a /health endpoint" --push --pr`. Дальше Shep запускает агента, коммитит результат, пушит ветку и открывает черновик запроса на слияние. Если CI падает, агент читает логи и пушит исправление, по умолчанию до трех попыток, после чего Shep останавливается и сообщает вам. Для сложных задач флаг `--no-fast` включает полный цикл: требования, исследование и план как версионируемые YAML-файлы с подтверждением на каждом шаге до первой строки кода. Состояние всех репозиториев и задач видно в веб-панели на `localhost:4050`, а то же самое делает CLI. Командой `shep app new` можно начать новое приложение, и каждая следующая задача привяжется к нему. Данные хранятся локально в `~/.shep` в SQLite, а код уходит только выбранному вам агенту.
Для кого. Для разработчиков, которые ведут несколько задач одновременно в Claude Code, Codex или Gemini CLI и хотят получать из них готовые запросы на слияние.
Подходит, если
- Нужно запустить три-пять независимых задач на одном репозитории и не получить конфликтов веток
- Хочется довести задачу от описания до черновика запроса на слияние одной командой, включая отправку ветки и просмотр CI
- Перед кодом нужны утвержденные требования и план, и вы готовы подтверждать их на каждом шаге
- Вы переключаетесь между агентами по задачам и хотите единый интерфейс поверх Claude Code, Codex и Gemini CLI
Не подходит, если
- У вас одна задача, и хватает самого агента в терминале
- Нельзя запускать агента с флагами обхода подтверждений: по умолчанию Shep передает их
- Репозиторий без доступа к GitHub CLI: в схему отправки ветки и запроса на слияние входит gh
- Нужен сканер безопасности: Shep оркестрирует агентов и уязвимостей кода не ищет
Пример запроса к агенту
Поставь Shep и запусти три задачи параллельно в этом репозитории: темная тема, редирект после логина и эндпоинт `/health`, каждую с черновиком запроса на слияниеОграничения
Нужны Node.js 22 или новее, pnpm 10, Git, GitHub CLI и авторизованный CLI хотя бы одного агента. Shep запускает агента без интерактивных вопросов и по умолчанию передает флаги отключения подтверждений, например `--dangerously-skip-permissions` для Claude Code. Метрики использования включены по умолчанию и отключаются командой `shep telemetry off` или переменной `DO_NOT_TRACK=1`. Поддержка Aider и Continue заявлена как будущая. Данные и журнал действий лежат в локальной базе в `~/.shep`, поэтому на общей машине учитывайте права на эту папку.
Как отключить. Команда `shep stop` останавливает демон, а `npm uninstall -g @shepai/cli` удаляет пакет. Данные лежат в `~/.shep` и удаляются вручную. Отдельного агента останавливает `shep agent stop <id>`.
Частые вопросы
Чем Shep отличается от запуска Claude Code напрямую?
Агент пишет код, а Shep берет на себя окружение: worktree, коммиты, отправка ветки, запрос на слияние, наблюдение за CI и повторные попытки. Разница заметнее всего на трех-пяти параллельных задачах.
Что происходит, если CI падает?
Агент читает логи и пушит исправление, по умолчанию до трех попыток. После этого задача встает в состояние Blocked, и Shep уведомляет вас. Код с упавшим CI Shep не сливает.
Сливает ли Shep запросы на слияние сам?
Нет, пока вы не передали флаг `--allow-merge`. По умолчанию он открывает черновик, а слияние остается за вами.
Какие агенты поддерживаются?
Встроены Claude Code, Kimi Code, Codex CLI, Copilot CLI, Cursor CLI, Gemini CLI и Cline, а также OpenRouter, Together AI, Ollama и любой OpenAI-совместимый прокси через HTTP.
Куда уходит мой код и что собирает Shep?
Данные хранятся локально в `~/.shep`, а код получает только выбранный вами агент. Метрики использования включены по умолчанию и отключаются командой `shep telemetry off`: содержимое промптов, код и имена репозиториев в них не входят.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКодинг-агент для терминала и рабочего стола: не засчитывает «готово» без тестов или diff и работает с DeepSeek, GLM, Kimi, Claude, Codex и Gemini
CLI дает шести кодовым агентам общий процесс: контекст проекта, более 80 скиллов, проверки и продолжение задач между сессиями
Утилита и скилл, с которыми Claude Code раздает задачи субагентам Claude, Codex или OpenCode в отдельных Git worktree
Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
CLI и 18 навыков: команда /wish ведет одну задачу в отдельной ветке, запускает проверки и открывает pull request
Скиллы команды Codely ведут работу агента по фазам: план в файле или GitHub Issues, ревью после каждой фазы и аккуратный коммит
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Shep (эта запись) | нет | 269 | |
| Claude Squad | нет | 8 694 | терминальное приложение для параллельных сессий агентов, без автоматической отправки ветки, запроса на слияние и наблюдения за CI |
| sudocode | нет | 295 | хранит спецификации и задачи в git как память для агентов, Shep ведет задачу по worktree до запроса на слияние |
Коротко о README
Главная страница показывает быстрый старт в три команды, схему работы от идеи до запроса на слияние и таблицу поддерживаемых агентов. Дальше идут таблицы флагов и команд, раздел о безопасности с оговоркой про флаги обхода подтверждений и сведения о метриках. Для вкладчиков есть ссылки на архитектуру и список задач для новичков.