Codex Guard CLI
Codex Guard проверяет PR от ИИ-агентов на TODO, утечки ключей, неряшливые коммиты и красный CI до слияния в основную ветку
- 132 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Действие читает изменения, статусы и комментарии PR и может блокировать слияние, поэтому ложное срабатывание останавливает работу команды
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/codex-guardОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Действие читает изменения, статусы и комментарии PR и может блокировать слияние, поэтому ложное срабатывание останавливает работу команды
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Действие GitHub, которое запускается на `pull_request`, определяет по метке, префиксу ветки или заголовку, что PR написал агент, и проверяет четыре вещи. Сканер незаконченного ищет `TODO`, `FIXME`, `XXX`, `HACK` и `WIP` только в добавленных строках. Сканер секретов ищет ключи AWS, GitHub, Google, OpenAI, Anthropic, Slack, Stripe, npm, SendGrid, Telegram, JWT и строки подключения, значения в отчетах скрыты. Проверка коммитов следит за соглашением `conventional commits`, а проверка CI ловит упавшие статусы на последнем коммите. Каждая находка попадает аннотацией проверки на точную строку файла, а сводка в комментарии к PR. Установщик `npx --yes codex-guard init` начинает в режиме наблюдения без блокировки, пресеты `balanced` и `strict` включают блокировку. Команда `codex-guard doctor` проверяет настройку только на чтение.
Для кого. Командам, чьи репозитории принимают PR от Codex, Claude Code и Copilot и которые хотят снять с ревьюера проверку очевидного.
Подходит, если
- Агент оставил `// TODO` и ключи из переписки в PR, а ревьюер заметил это только вручную
- Нужно блокировать слияние, если на последнем коммите упал CI или статус
- Сообщения коммитов вроде `WIP` и `fix stuff` надо отсеять по соглашению `conventional commits`
- Начинать надо мягко: сначала режим наблюдения без блокировки, затем пресет `balanced`
Не подходит, если
- Репозиторий не на GitHub: проект работает как действие GitHub
- Нужен смысловой ревью кода: проверки детерминированные и ищут шаблоны
- Нужна проверка всех PR подряд: по умолчанию проверяются только PR, похожие на агентские
Пример запроса к агенту
Подключи Codex Guard в этом репозитории в режиме наблюдения и покажи, что он нашел бы в последних трех PR агентаОграничения
- Работает как действие GitHub: нужно разрешение `statuses: read` в блоке `permissions` workflow, иначе проверка статусов не отработает.
- PR признается агентским по метке `codex-generated`, `agentic` или `ai-generated`, по префиксу ветки или по заголовку, остальные пропускаются. Метка `codex-guard-ignore` отключает проверку.
- GitHub иногда не отдает текстовый патч бинарных и очень больших файлов, и отчет помечает такие файлы как непросмотренные, чистыми их не считает. Предел API файлов PR равен 3000.
- Проверки детерминированные: смысла кода они не оценивают.
- Последний коммит репозитория датирован сентябрем 2026 года.
Как отключить. Удалите workflow-файл с `Akimiya-z/codex-guard@v1` из `.github/workflows/` и конфигурацию политики. Установщик `codex-guard` ничего глобально не ставит.
Частые вопросы
Как подключить Codex Guard?
Выполните `npx --yes codex-guard init`: установщик создаст workflow на `Akimiya-z/codex-guard@v1`. Он начинает в режиме наблюдения, а `--preset balanced` или `--preset strict` включают блокировку.
Как Codex Guard понимает, что PR от агента?
По метке, префиксу ветки или заголовку. Метки по умолчанию `codex-generated`, `agentic` и `ai-generated`, список задается параметром `agent-labels`.
Как пропустить проверку для одного PR?
Добавьте на PR метку `codex-guard-ignore`, имя метки меняется параметром `ignore-label`.
Что проверяется в секретах?
Ключи AWS, GitHub, Google, OpenAI, Anthropic, Slack, Stripe, npm, SendGrid и Telegram, JWT, строки подключения Azure и жестко заданные учетные данные. Значения в отчетах скрыты.
Как проверить настройку?
Выполните `npx --yes codex-guard doctor`, а для машиночитаемого вывода `npx --yes codex-guard doctor --json`. Команда работает только на чтение и возвращает код 1 при ошибке настройки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI проверяет пакеты npm, Python и Rust перед публикацией по реальному архиву и пишет Codex узкое задание с доказательствами.
Обертка над GitHub CLI для агентов: компактный вывод TOON, подсказки следующего шага и структурные ошибки для issues, PR, CI и релизов
Скилл раскладывает правки на логичные коммиты по Conventional Commits и безопасно ведет ветки, отправку и pull request.
Расширение gh для агентных воркфлоу: задача описывается в Markdown и запускается агентом в GitHub Actions
Плагины Diffinery для Claude Code и Codex подключают агента к самохостингу Git, пул-реквестов и CI на Cloudflare через MCP-сервер
Утилита на Zig для переключения аккаунтов Codex: импорт файла авторизации, список, переключение, для CLI, VS Code и приложения
Коротко о README
README объясняет, чем PR агентов отличаются от обычных, и таблицей перечисляет четыре проверки. Затем идут установка через `npx`, пресеты, параметры действия, метки и пример реального отчета на самом репозитории.