Codex Maintainer CLI
CLI и GitHub Action для мейнтейнеров: разбирает issue, ревьюит запросы на слияние и пишет заметки к релизу со ссылками на код.
- 83 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Отправляет контекст репозитория во внешний API OpenAI и использует токен GitHub.
- С флагом `--comment` пишет комментарий в issue или pull request.
Установка
- Работает в
Ручная установка
git clone https://github.com/snakyvine/codex-maintainer.gitПервый шаг установки из исходников, затем `npm ci --ignore-scripts` и `npm link --ignore-scripts` в папке клона.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Отправляет контекст репозитория во внешний API OpenAI и использует токен GitHub.
- С флагом `--comment` пишет комментарий в issue или pull request.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Codex Maintainer читает контекст репозитория, просит модель OpenAI дать структурированный разбор и сверяет ответ с доказательствами. Команды `triage` и `review` работают с issue и запросами на слияние, `release` собирает заметки к тегу по коммитам и слитым запросам, `analyze` строит локальный индекс без модели. Инструмент только советует: он не одобряет, не сливает, не закрывает и не правит код. Каждая находка должна цитировать код и указывать файл и строку, а отчет говорит, что осталось непроверенным. Комментарий в GitHub пишется только с явным `--comment`.
Для кого. Мейнтейнерам открытых проектов, которые хотят предварительный разбор issue и запросов на слияние, но оставляют решение за собой.
Подходит, если
- Очередь issue растет, и каждому нужен краткий разбор с отсылками к коду.
- Запрос на слияние нужно проверить до ручного ревью, чтобы находки были привязаны к строкам.
- К тегу `v1.2.0` нужны заметки к релизу со ссылками на слитые изменения.
- Хочется запускать разбор на событиях `issues` и `pull_request` в GitHub Actions.
Не подходит, если
- Нужен автоматический аппрув, слияние или закрытие: инструмент этого не делает.
- Код нельзя отправлять во внешний API OpenAI.
- Нужна установка одной командой из npm: пакета в реестре пока нет.
Пример запроса к агенту
Разбери issue 123 и покажи, какие файлы стоит открыть, не оставляя комментарий в репозитории.Ограничения
Пакет не опубликован ни в npm, ни в GitHub Marketplace: ставить нужно из исходников, нужен Node.js 22.12.0 или новее. Для `triage` и `review` нужны ключ OpenAI API и токен GitHub с правами на репозиторий. Проект независимый и не связан с OpenAI. Демо и локальный `analyze` работают без ключей. Верная цитата сама по себе не доказывает ошибку. Решение остается за мейнтейнером, а отчет перечисляет то, что инструмент не проверял.
Как отключить. Удалите ссылку командой `npm unlink` и папку клона. Если подключали GitHub Action, уберите файл сценария из `.github/workflows`, а ключ OpenAI и токен GitHub отзовите в своих настройках.
Частые вопросы
Как попробовать без ключей?
Выполните `codex-maintainer demo`. Демо работает без учетных данных и сети после установки и пишет `triage.md`, `review.md` и `release.md` в `demo-output`.
Оставляет ли инструмент комментарии сам?
Нет, только с флагом `--comment` или `comment: 'true'` в Action. Тогда пишется один комментарий с рекомендацией.
Какие переменные окружения нужны?
`OPENAI_API_KEY` и `GITHUB_TOKEN` для `triage` и `review`. Удаленному `analyze` хватит `GITHUB_TOKEN`, демо обходится без них.
Как запустить разбор в GitHub Actions?
Подключите Action на события `issues` и `pull_request`. Он пишет сводку задания и временные файлы отчета, а комментарий оставляет только при `comment: 'true'`.
Можно ли запускать инструмент через npx?
Пока нет: пакета в npm нет, а в README сознательно нет примера с `npx`. Без `npm link` используйте `node` и путь к `dist/cli/index.js`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI со скиллом ищет открытые issues GitHub и оценивает их, отбирая подходящие под стек, а исправление и PR остаются за Codex.
Навык Codex для аудита здоровья репозитория: тесты, CI, зависимости, безопасность и техдолг с доказательствами.
CLI и плагин для ревью кода агентом: читает git diff и пишет замечания по строкам с учетом контекста
CLI для сопровождающих проектов: ревью pull request, разбор упавшего CI и анализ синхронизации форка по уликам репозитория.
CLI дает шести кодовым агентам общий процесс: контекст проекта, более 80 скиллов, проверки и продолжение задач между сессиями
Codex Bridge отдает вопросы и анализ файлов из Claude Code, Cursor и VS Code в официальный Codex CLI через MCP на Python.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Codex Maintainer (эта карточка) | нет | 83 | |
| Maintainer Autopilot | нет | 99 | запускает правки ИИ как конвейер с проверками перед слиянием; Codex Maintainer только разбирает и советует, сверяя находки с файлами и строками |
| claude-pr-review | нет | 115 | команда /pr-review с пятью проверяющими для одного запроса на слияние; здесь добавлены разбор issue и заметки к релизу на модели OpenAI |
Коротко о README
Таблица команд, схема проверки доказательств и порядок установки из исходников с безопасным демо. Отдельно перечислены режимы записи: по умолчанию инструмент только читает.