Una revisión de código que se lanza sola antes de cada git push, con 22 escáneres y un segundo agente que no ha visto la sesión en la que se escribió el cambio. Eso es openqodex, una skill y plugin con licencia Apache-2.0 que publicó su primera versión en npm el 2 de octubre de 2026 y va ya por la 0.14.0, del 23 de octubre, con más de 800 estrellas en GitHub. Funciona en Claude Code, Codex CLI, Cursor y Cline.
Qué hace: escáneres primero, un revisor sin memoria después
La skill se activa antes de cualquier git push, cuando pides una revisión o un escaneo de seguridad, cuando el hook de openqodex ha avisado o bloqueado un push y después de corregir hallazgos, para volver a comprobar. El agente no revisa nada por su cuenta: llama a openqodex review, que trabaja sobre los commits sin subir y los cambios sin commitear (o sobre todo el repositorio con --all).
Lo interesante es cómo reparte el trabajo:
- Pasa los escáneres que encajan con los ficheros cambiados y se queda solo con los hallazgos en líneas modificadas. Son 22 integrados: secretos (gitleaks), seguridad en el código (semgrep, entre otros), dependencias con vulnerabilidades (osv-scanner), lint, workflows de GitHub Actions, Dockerfiles, Terraform, Kubernetes (kubeconform), CloudFormation y migraciones SQL.
- Lanza un proceso aparte de Claude Code o Codex, sin memoria de tu sesión, que lee una copia congelada del cambio con el código que lo llama y propone problemas citando la línea exacta.
- Un script comprueba que cada cita existe en el código, y otras sesiones verificadoras confirman o descartan cada candidato y cada hallazgo de los escáneres, con su motivo.
- Otros scripts validan que se ha respondido a todos los hallazgos y que el revisor ha recibido todas las líneas cambiadas. Los comentarios de estilo y nombres salen como observaciones y no bloquean.
El resultado es un recibo con el veredicto, una línea por hallazgo y la ruta a report.html, más copias en Markdown, JSON y SARIF dentro de .openqodex/reviews/, que queda fuera de git. Después, la skill obliga al agente a preguntar "¿arreglo todo o cuáles?" y a no tocar código hasta que respondas.
Cómo instalarla y usarla
Necesita Node 22 o superior, git, macOS o Linux (Windows y WSL no están probados) y Claude Code o Codex con sesión iniciada para la revisión completa. La instalación completa, con skill, hooks y pre-push de git, es interactiva con npx openqodex init, o sin preguntas:
npx -y [email protected] init --yes --agent claude-code
npx -y [email protected] reviewEl código de salida resume el veredicto: 0 si nada bloquea el push, 1 si está blocked y 2 si no hay una revisión completa. Si solo quieres la skill, sin hooks, está npx skills add openqodex/openqodex -g. Para revisar una rama o un pull request vale review feature/login o review '#42' (con comillas, porque # abre un comentario en la shell).
Por defecto solo avisa. Para que el hook bloquee el push hay que fijar un umbral de severidad (critical, major, minor, nitpick o info) en .openqodex/config.yaml:
review:
block_on_severity: majorRiesgos y límites
- Tu código sale hacia el modelo. No pide cuenta ni API key propia: usa el login de Claude Code o Codex, y el cambio viaja al servicio de ese login. El revisor puede además buscar en la web salvo que pongas
reviewer_web: off. - Escáneres con red. semgrep descarga reglas de su registro, osv-scanner envía nombres y versiones de dependencias a osv.dev, kubeconform baja esquemas y cargo-deny la base de RustSec.
--offlinelos salta. El proyecto dice no recoger telemetría y desactiva las métricas de semgrep. - Escáneres de terceros. Puedes añadir uno propio desde un repo de GitHub, pero solo se ejecuta tras aprobarlo con
openqodex trust; la skill prohíbe al agente hacerlo sin preguntarte. - El bloqueo se puede saltar.
git push --no-verifyevita el hook de git, y en Cursor y Cline el "bloqueo" es solo una regla que pide al agente revisar. Allí, además, el revisor tiene que ser Claude Code o Codex. - Dependencias que no instala. brakeman y rubocop necesitan Ruby, golangci-lint necesita Go y cargo-deny necesita Cargo.
La cautela que más pesa está en sus propias cifras. En su conjunto de pruebas con bugs sembrados, el revisor con Claude Code (claude-opus-5-5) encuentra 129 de 153 problemas (84,3 %) por unos 0,087 $ por revisión. En AACR-Bench, con pull requests reales y un revisor gpt-6.1-sol, el recall semántico baja al 5,2 % y el ruido sube al 77,2 %. Es un buen filtro previo, no una garantía; el propio README lo dice y el proyecto se presenta "camino de la 1.0", con comandos que pueden cambiar entre versiones menores.
openqodex frente a /security-review de Claude Code
La referencia obvia es lo que Anthropic ya incluye: el comando /security-review de Claude Code y su versión como GitHub Action, claude-code-security-review.
| openqodex | claude-code-security-review | |
|---|---|---|
| Cuándo corre | Antes del push (skill + hooks) y en PRs | En PRs (Action) o a mano con /security-review |
| Escáneres | 22 integrados + verificación por IA | Solo análisis con Claude |
| Alcance | Seguridad, dependencias, IaC, lint, SQL | Seguridad |
| Credenciales | Login de Claude Code o Codex; API key solo en la Action | API key de Anthropic en la Action |
| Bloqueo | Hook de push con umbral configurable | Comentarios en el PR |
| Licencia | Apache-2.0 | MIT |
La Action de Anthropic avisa de que no está protegida frente a prompt injection y recomienda usarla solo con PRs de confianza; filtra además a propósito categorías como denegación de servicio o redirecciones abiertas. openqodex cubre más terreno y llega antes, en tu máquina, pero añade una herramienta que madura a golpe de versión semanal. Si trabajas solo con Claude Code y te basta la seguridad, /security-review ya está ahí. Si quieres escáneres deterministas en el mismo flujo y una puerta antes del push que funcione con varios agentes, openqodex merece una prueba en un repo no crítico.