repo-harness: CLI-инструмент для обработки GitHub-заданий с AI
repo-harness — это CLI-инструмент, обрабатывающий GitHub-задания с применением AI, таких как Claude и Codex, для создания pull request’ов, которые можно оценить.
Проект призван упростить работу разработчиков и маленьких команд, используя AI для написания кода, оставляя человеку только функционал проверки изменений. repo-harness сохраняет контекст задач в рамках GitHub-issues и PR-ов, что позволяет продолжать работу над проектом, переходя между сессиями и машинами, не теряя информации о выполнении задач.
Проект написан на JavaScript и работает на Bun. Чтобы использовать repo-harness, нужно установить его через npm. Обрати внимание, что данный инструмент пока не поддерживает рабочие процессы команд и лучше всего подходит для индивидуальных разработчиков. Если ты работаешь в небольшой команде и ты готов тестировать, этот проект может существенно упростить интеграцию AI в твои процессы разработки.
repo-harness — это инструмент командной строки (CLI), набор хуков и навыков, который позволяет интегрировать ИИ-агентов, таких как Claude, Codex и Pi, в существующий репозиторий GitHub. Он предназначен для упрощения длительных инженерных задач, позволяя агента выполнять кодирование, а человеку оставляя задачу лишь в принятии решения о слиянии изменений.
Зачем нужен проект?
Проект создан для разработчиков и небольших команд, работающих с ИИ. Главная цель — обеспечить возможность длительной работы агента над проектом с сохранением контекста и структурированного подхода, что делает процесс более организованным. repo-harness решает проблемы, возникающие при работе нескольких сессий, сохраняя контекст задач и предостерегая от ошибок.
Как работает проект?
В проекте реализованы три основных слоя:
- Authority: Задачи, объем работ и статус хранятся в GitHub issue и PR.
- Контекст репозитория: Служебные файлы и документация хранятся в вашем репозитории и написаны самим repo-harness.
- Исполнение: CLI и хуки, которые выполняют команды и управляют структурой проекта.
При использовании проекта ИИ-агент получает всю необходимую информацию из issue и PR, что позволяет ему продолжать работу с места, где остановилась предыдущая сессия.
Как установить и запустить?
Prerequisites: у тебя должен быть установлен Git, необходим Bun (≥ 1.4.0) и инструмент hc для подготовки хостов. Для macOS и Linux необходим bash, для Windows — Git для Windows. Node.js не требуется.
Для установки выполните следующие команды:
# 1. Установить CLI и адаптеры хуков
curl -fsSL https://raw.githubusercontent.com/aimpact-inc/repo-harness/main/install.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/aimpact-inc/repo-harness/main/install.ps1 | iex
Если Bun уже установлен, можно использовать:
bunx repo-harness@latest install
После установки переходи в корневую папку репозитория, который хочешь адаптировать, и запусти:
repo-harness init --dry-run # Посмотреть, какие файлы будут созданы
repo-harness init
Что ты получаешь?
Используя repo-harness, ты можешь рассчитывать на:
- Не прерывающийся поток работы: сессии могут заканчиваться в середине задач и продолжаться позже с того места, где остановились.
- Контекст задач и проверки: хуки обеспечивают защиту от редактирования и сохраняют необходимые проверки состояния.
- Отдельную проверку выполненной работы и принятие изменений: у каждого процесса есть свои права, и для принятия решения используется отдельная проверка.
- Доступ к инструментам и консоли для управления задачами и агентами.
Ограничения
Важно понимать, что repo-harness не является хостингом для ИИ-агентов, не выполняет автоматическую работу и не заменяет процесс сборки, тестирования или развертывания. Он не сам по себе управляет задачами, а предоставляет инструменты для рукопашного взаимодействия между человеком и ИИ.
С помощью этого проекта тебе не придется снова просматривать всю историю чата — вся информация о задачах будет храниться в виде issue и PR, что заметно облегчит процесс разработки.
Радар проекта: 69 из 100 — крепкий проект
- Импульс 20 ≈ 2 звезды в день
- Темп разработки 100 2198 коммитов за 12 недель
- Зрелость 80 проекту 8 месяцев, 91 релиз
- Сообщество 45 11 участников, 35 форков
- Свежесть 99 последний коммит — 1 день назад
- Быстрый старт 75 есть: команда установки, сайт/демо, примеры
- Готовность к продакшену 75 релиз v0.30.0, автосборка, тесты
- Безопасность и доверие 60 лицензия MIT, организация
- Документация 93 README 17.4 тыс. знаков, 21 раздел, папка docs
- Экосистема 47 2 подписчика на обновления, 7 тем
Как считаем
Только открытые данные GitHub на 11.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: aimpact-inc/repo-harness →
RepoRadar