repo-harness — рабочий процесс агентов Claude, Codex и Pi в репозитории
repo-harness
CLI, хуки и скиллы для долгой работы Claude, Codex и Pi: задачу ведут issue и PR, а на ревью приходит PR с проверками
- 435 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик дописывает хуки в `~/.claude/settings.json` и `~/.codex/hooks.json`, и они срабатывают в каждой сессии подключенных репозиториев
- Команда `repo-harness publication merge` сливает PR, когда в базовой ветке включена политика `acceptance_merge`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/repo-harnessОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик дописывает хуки в `~/.claude/settings.json` и `~/.codex/hooks.json`, и они срабатывают в каждой сессии подключенных репозиториев
- Команда `repo-harness publication merge` сливает PR, когда в базовой ветке включена политика `acceptance_merge`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`repo-harness` оборачивает существующий репозиторий так, чтобы Claude, Codex и Pi вели в нем долгую инженерную работу между сессиями, машинами и worktree. Задачей владеют GitHub issue и PR: имя ветки указывает на issue, и новая сессия агента перечитывает issue и PR и продолжает с названного там шага, а не с пересказа старого чата. Команда `repo-harness init` кладет в репозиторий `AGENTS.md` и `CLAUDE.md`, папки `docs/` и `.ai/`, файл `tasks/lessons.md` и блок в `.gitignore`. Сами помощники в репозиторий не копируются, они вызываются через `repo-harness run`. Глобальные адаптеры в `~/.claude/settings.json` и `~/.codex/hooks.json` отправляют события агента в типизированные обработчики: на старте сессии они подгружают контекст, а охранники `RepoScopeGuard`, `ExternalReferenceGuard`, `OpsPrivateGuard`, `EditScopeGuard` и `ApplyPatchScopeGuard` блокируют правки вне границ задачи с одной строкой причины и подсказкой `Fix:`. В репозиториях, которые не подключены, хук молчит. В PR агент оставляет изменения, выполненные проверки, список того, что осталось под вопросом, и план отката. Когда нужна строгая приемка, отдельный изолированный ревьюер делает до трех кругов правок. Есть локальная веб-панель `repo-harness operator serve` только на локальном адресе, MCP-сервер `repo-harness mcp serve` и 12 скиллов, которые разделены на скиллы для оркестратора («Bot») и исполнителей («Worker»).
Для кого. Одиночным разработчикам и небольшим командам, которые отдают код агентам и оставляют себе решение, принимать ли изменение.
Подходит, если
- Задача растет дольше одного чата, и новая сессия должна продолжить с ветки, issue и PR
- Работа идет попеременно в Claude и Codex на разных машинах или в разных worktree
- Агенты правят файлы за пределами задачи, и нужны хуки, которые блокируют такие правки с понятной причиной
- На ревью приходит PR, где проверки, открытые вопросы и план отката собраны в одном месте
- Локальный MCP-клиент читает состояние репозитория и пишет PRD без доступа к исходному коду
Не подходит, если
- Задачи ведутся вне GitHub: источником правды выступают issue и PR
- Нужен планировщик или фоновый диспетчер: repo-harness сам ничего не запускает и не ставит в очередь
- Нужна среда для размещения агентов или замена сборки, тестов и релиза: инструмент их не заменяет
- Права на глобальные настройки агентов недоступны: адаптеры записываются в `~/.claude/settings.json` и `~/.codex/hooks.json`
Пример запроса к агенту
Возьми issue 42 из этого репозитория, сделай задачу в отдельной ветке и оформи PR с проверками, открытыми вопросами и планом откатаОграничения
Нужны Git, Bun 1.4 или новее (установщик ставит или обновляет его сам) и `hc` (herdr-core) для проверки готовности агентов. На macOS и Linux нужен `bash`, на Windows Git for Windows. Установка отдельной командой `bunx repo-harness@latest install` Node.js не требует.
Для Codex файл хуков отмечают доверенным в настройках приложения. Репозиторий включается в работу только после `repo-harness init`, до этого хук тихо завершается. Слияние PR командой `repo-harness publication merge` разрешено только при включенной политике `acceptance_merge` в базовой ветке.
Как отключить. Команда `repo-harness uninstall --dry-run` показывает, что будет удалено, а `repo-harness uninstall` убирает глобальный рантайм и адаптеры из настроек агентов. Файлы в репозитории удаляют вручную.
Частые вопросы
Как поставить repo-harness?
Выполните `curl -fsSL https://raw.githubusercontent.com/Ancienttwo/repo-harness/main/install.sh | sh`; если Bun уже есть, подойдет `bunx repo-harness@latest install`. Затем в корне репозитория запустите `repo-harness init --dry-run` и после просмотра `repo-harness init`.
С какими агентами работает repo-harness?
С Claude (5 маршрутов хуков через `~/.claude/settings.json`), Codex (5 маршрутов через `~/.codex/hooks.json`) и Pi. Pi подключается автоматически, если `pi` есть в PATH.
Что остается в репозитории после init?
`AGENTS.md`, `CLAUDE.md`, `docs/`, `tasks/lessons.md`, `.ai/`, `deploy/`, приватная папка `_ops/` и один управляемый блок в `.gitignore`. Скрипты помощников в репозиторий не копируются.
Что такое приемочное ревью?
Постоянный изолированный ревьюер работает в связанной копии репозитория и делает до трех кругов правок на один PR. Результат фиксируется как приемочная квитанция, привязанная к итоговому содержимому. Команды: `repo-harness review round`, `status` и `close`.
Что делает MCP-сервер repo-harness?
Команда `repo-harness mcp serve --repo . --profile planner` дает локальному MCP-клиенту читать состояние репозитория и писать PRD. Запись в исходный код по умолчанию отключена, а `repo-harness mcp doctor --repo .` проверяет настройку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыRepository Harness ставит в репозиторий файл AGENTS.md, карту документов и явно вызываемые скиллы для онбординга, а затем безопасно обновляет их
Каждому кодинг-агенту отдельная копия репозитория со своими портами и базой, а проверка результата идет одним и тем же конвейером.
Плагин Claude Code с навыками /readiness и /setup оценивает готовность проекта к работе агентов и ставит правила и проверки.
Python-среда для работы агентов: границы задачи, независимая проверка результата и сохраненная передача между сессиями
Agent Harness Kit — рабочий процесс для агентов
Agent Harness Kit
CLI ahk разворачивает в проекте пять ролей агентов, MCP-сервер задач и навыки спецификаций для Claude Code, Codex и Cursor
Скиллы команды Codely ведут работу агента по фазам: план в файле или GitHub Issues, ревью после каждой фазы и аккуратный коммит
Коротко о README
README объясняет, зачем нужна обвязка вокруг агента (контекст живет в issue и PR, проверки отделены от приемки), и показывает установку, схему работы и пример из двух сессий. Дальше идут таблица команд, панель оператора, список скиллов, поддерживаемые агенты и ссылки на документацию. Лицензия MIT.