Codebase Argus CLI
CLI для сопровождающих проектов: ревью pull request, разбор упавшего CI и анализ синхронизации форка по уликам репозитория.
- 59 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает патчи и логи из GitHub, отправляет улики выбранным провайдерам моделей и работает с токеном GitHub.
Установка
- Работает в
Ручная установка
git clone https://github.com/AaronZ345/codebase-argus.gitЗатем `npm ci` в каталоге и `npm run argus -- review owner/repo#123` для первого запуска.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает патчи и логи из GitHub, отправляет улики выбранным провайдерам моделей и работает с токеном GitHub.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Codebase Argus проверяет запросы на слияние, логи упавших сборок и долгоживущие форки по одному набору сигналов: патчи, проверки, файлы, состояние веток, правила и локальные симуляции git. Детерминированный проход работает локально, только на чтение и без ключа модели. По желанию те же улики отдают одной модели, нескольким сразу или локальным CLI вроде `codex-cli` и `claude-cli`, а каждая находка остается привязанной к проверяемому факту. Команды запускаются через `npm run argus`: `review` для запроса на слияние, `ci-log` и `ci-github` для сборок, `downstream` для форка и апстрима. Для форка Argus оценивает отставание, прогнозирует конфликты через `git merge-tree` и имитирует перебазирование во временном рабочем дереве. Рядом есть плейбук агента `skills/codebase-argus/SKILL.md`, GitHub Action и приложение GitHub.
Для кого. Сопровождающим открытых проектов и форков, которым одного рецензента мало, а бот, который сливает изменения сам, не подходит.
Подходит, если
- Крупный запрос на слияние нужно показать нескольким моделям и сравнить их выводы.
- Сборка в GitHub Actions упала, и надо быстро найти причину и команду, которую стоит повторить.
- Форк отстает от апстрима, и перед перебазированием хочется увидеть вероятные конфликты.
- В запросах на слияние нужен автоматический комментарий с итогом проверки в сводке задания.
Не подходит, если
- Нужен бот, который сам сливает изменения без участия человека.
- Репозиторий не на GitHub: источники данных заточены под него.
- Нужна замена нормальному рецензенту, знающему архитектуру проекта.
Пример запроса к агенту
Проверь pull request zhayujie/CowAgent#2965 и покажи находки и вопросы, которые стоит задать автору.Ограничения
Для запуска нужны Node.js, npm и git, установка идет клонированием с `npm ci`. Приватные репозитории, повышенные лимиты API и логи GitHub Actions требуют `GITHUB_TOKEN`, а провайдеры моделей просят свои ключи `OPENAI_API_KEY` и `ANTHROPIC_API_KEY`. Автоисправление строит только план ветки для механических правок и не меняет код само. Качество ревью зависит от выбранных моделей, итоговое решение остается за сопровождающим.
Как отключить. Удалите склонированный каталог и, если подключали, GitHub Action из рабочего процесса и приложение GitHub из настроек организации. Токены удалите из переменных окружения.
Частые вопросы
Нужен ли ключ модели для первого запуска?
Нет. Первый проход ничего не отправляет наружу. Ключи пригодятся для проверки несколькими моделями.
Как запустить ревью несколькими моделями?
Передайте флаг `--tribunal`: например, `npm run argus -- review owner/repo#123 --tribunal openai-api,claude-cli,codex-cli`. Argus покажет, где модели согласны или расходятся.
Как разобрать упавшую сборку?
Для локального лога служит `ci-log`, для сборки в GitHub Actions `ci-github` с токеном. Результат содержит вероятную причину и затронутую команду.
Как подключить к запросам на слияние?
Через GitHub Action `AaronZ345/codebase-argus-action@v1`: сводка с ревью появляется в задании.
Что делает режим downstream?
Сравнивает форк с апстримом: отставание, вероятные конфликты, сложность перебазирования или слияния, и пишет заметки для ручного решения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и плагин для ревью кода агентом: читает git diff и пишет замечания по строкам с учетом контекста
CLI и GitHub Action для мейнтейнеров: разбирает issue, ревьюит запросы на слияние и пишет заметки к релизу со ссылками на код.
reviewd проверяет pull request из GitHub, GitLab и BitBucket через Claude Code, Gemini или Codex CLI и комментирует их
agnix — линтер для CLAUDE.md, AGENTS.md, SKILL.md, хуков и MCP-конфигов: 702 правила, автофикс и редакторские расширения для VS Code и JetBrains
GitHub Action и CLI: несколько моделей параллельно ревьюят pull request, а дубли сводятся в один отчет с ценой.
Индексирует кодовую базу в граф знаний и отдает агенту через MCP связи вызовов, радиус влияния правок и поиск по коду
Коротко о README
Argus позиционируется как рабочее место ревью для сопровождающих: один набор улик подается разным рецензентам, а каждое замечание подкрепляется проверяемым фактом. README показывает локальный запуск, Action, режимы CLI и разбор реального запроса.