OpenQodex CLI

Установка

Работает в

• Claude Code
• Codex
• Cursor
• Cline

Ручная установка

npx openqodex init

Что делает

OpenQodex ставится командой `npx openqodex init` и проверяет код до `git push`. Проверяемые изменения — это непушнутые коммиты и все незафиксированные правки. Команда `openqodex review` сначала запускает сканеры, подходящие к измененным файлам: встроено 22 сканера для секретов, уязвимостей в коде и зависимостях, линтеров, воркфлоу GitHub Actions, Dockerfile, Terraform, Kubernetes, SQL и миграций. Находки на измененных строках остаются, находки в тестовых данных и в отключенных правилах отбрасываются. Потом запускается ревьюер: отдельный процесс Claude Code или Codex на вашем собственном входе, без дополнительных ключей. По умолчанию агент, написавший код, его не проверяет. Ревьюер получает все измененные строки и обязан по каждой находке сканера подтвердить ее или снять с причиной, а скрипты проверяют, что ответ дан по всем находкам. Claude Code запускается без ваших настроек и только с инструментами чтения, поиска и просмотра, Codex в песочнице только на чтение. Итог команда печатает в виде квитанции: вердикт, строка на находку и путь к `report.html`. Рядом пишутся `report.md`, `report.json` и `report.sarif`. Навык просит агента показать квитанцию и спросить, какие находки исправлять. Режим `review --all` проверяет весь репозиторий, `review <ветка>` ветку, `review '#42'` пулл-реквест. `init` показывает список файлов, которые запишет, и один раз спрашивает согласие. Он создает глобальные инструкции агентов, ловушку на `git push` для Claude Code и Codex, правила для Cursor и Cline, хук `pre-push` в репозитории и MCP-сервер `openqodex`, который отвечает на вопросы по графу кода, например, кто вызывает функцию. Свой сканер подключают в `.openqodex/config.yaml` и утверждают командой `openqodex trust`.

Для кого. Для разработчиков и команд, которые пишут код в Claude Code, Codex, Cursor или Cline и хотят проверять изменения сканерами и независимым ревьюером до пуша, не заводя отдельный ключ для модели.

Пример запроса к агенту

Проверь мои изменения через openqodex перед пушем и покажи находки, я скажу, какие исправлять

Ограничения

• Лицензия Apache-2.0. Проект идет к версии 1.0: команды, ключи и файл настроек могут меняться между минорными релизами.
• Нужны Node.js 22 или новее и git. Пакет проверяется на macOS и Ubuntu, на Windows и WSL тестов нет. Часть сканеров требует среды выполнения, которую OpenQodex не ставит: brakeman и rubocop нужен Ruby, golangci-lint нужен Go, cargo-deny нужен Cargo.
• Ревьюером могут быть только Claude Code и Codex. Cursor на эту роль не годится. В песочнице Codex второй процесс Codex не запускается. Без ревьюера команда `review` печатает «Full review unavailable» и завершается с кодом 2.
• Хук в агенте проверяет наличие ревью текущей работы, а не содержимое пуша. Хук `pre-push` смотрит точные коммиты, но `git push --no-verify` его пропускает. По умолчанию обе проверки только предупреждают. Пуш они блокируют, когда в `.openqodex/config.yaml` задан `review.block_on_severity`.
• Автор приводит свой замер: на размеченных ошибках Claude Code нашел 129 из 153, Codex 115 из 153. Все проблемы не находит ни один режим, отчет называет этапы, которые не запустились.
• Локальной копии баз уязвимостей нет: osv-scanner обращается к osv.dev, а cargo-deny скачивает базу RustSec. Флаг `--offline` отключает такие сканеры, но ревьюер все равно отправляет изменения в модель вашего входа.

Как отключить. Команда `openqodex init --uninstall` убирает записанные `init` разделы и файлы, не трогая ваш текст рядом. Ключ `init --hook none` отключает хук `pre-push`, а `--no-mcp` пропускает регистрацию MCP-сервера. Папка `~/.openqodex` содержит сканеры, кэш и утвержденные записи, ее можно удалить вручную.

Коротко о README

В репозитории лежат CLI одним файлом, навык, шаблоны для агентов, документация и демонстрация. Описание проекта разбирает установку, роли агентов, требования, ход проверки, ограничения и 22 встроенных сканера. Дополнительно есть замеры на размеченных ошибках, примеры отчетов, плагины для Claude Code и Cursor, действие GitHub Actions и хук pre-commit.