Herramienta CLI impulsada por IA que revisa el código en busca de vulnerabilidades de seguridad, errores y antipatrones utilizando LLMs. Admite proveedores locales y en la nube, diferencias de git e integración con CI/CD.
Revisión de código impulsada por IA en tu terminal.
Un comando. Comentarios instantáneos. Detecta vulnerabilidades de seguridad, errores y malas prácticas antes de que lleguen a producción.
Instalación · Inicio rápido · Uso · Proveedores · Contribuir
codereview envía tu código a un LLM y devuelve una revisión estructurada y codificada por colores directamente en tu terminal — con clasificaciones de gravedad, referencias de línea y sugerencias concretas de corrección.
Sin navegador. Sin necesidad de PR. Sin esperar a compañeros. Solo:
codereview app.py
| Gravedad | Lo que encuentra | Ejemplo |
|---|---|---|
| 🔴 Crítico | Vulnerabilidades de seguridad, pérdida de datos, fallos | Inyección SQL, eval() en entrada de usuario, secretos hardcodeados |
| 🟡 Advertencia | Errores, falta de manejo de errores, condiciones de carrera | División por cero, excepciones no capturadas, fugas de recursos |
| 🔵 Información | Mejoras de rendimiento, mejores patrones | Asignaciones innecesarias, faltas de caché, consultas N+1 |
| ⚪ Estilo | Nombrado, formato, documentación | Faltas de docstrings, nombrado inconsistente, código muerto |
git clone https://github.com/jaydendancer12/ai-code-review.git
cd ai-code-review
./install.sh
O manualmente:
git clone https://github.com/jaydendancer12/ai-code-review.git
cd ai-code-review
pip install -e .
Todas las dependencias (rich, requests) se instalan automáticamente. No hay nada más que configurar.
codereview necesita un LLM para analizar tu código. La opción gratuita más rápida es Groq — sin tarjeta de crédito, sin prueba, solo gratis.
export GROQ_API_KEY="gsk_tu_clave_aqui"
Para hacerlo permanente (para no tener que configurarlo en cada sesión de terminal):
# Para zsh (predeterminado en Mac)
echo 'export GROQ_API_KEY="gsk_tu_clave_aqui"' >> ~/.zshrc
source ~/.zshrc
# Para bash (predeterminado en Linux)
echo 'export GROQ_API_KEY="gsk_tu_clave_aqui"' >> ~/.bashrc
source ~/.bashrc
codereview --init groq
codereview tu_archivo.py
Eso es todo. Ya estás ejecutando revisiones de código con IA.
¿Es la primera vez que lo ejecutas? Simplemente escribe codereview sin argumentos y te guiará a través de toda la configuración.
codereview app.py
codereview src/auth.py src/db.py src/api.py
git add .
codereview --staged
codereview --last 3
codereview --diff origin/main
cat suspicious_code.py | codereview --stdin
codereview app.py --model gpt-4
codereview app.py --provider ollama
codereview --setup
codereview funciona con cualquier API compatible con OpenAI. Elige la que mejor se adapte a ti:
export GROQ_API_KEY="gsk_tu_clave_aqui"
codereview --init groq
# 1. Instala Ollama
# Mac: Descarga desde https://ollama.com
# Linux: curl -fsSL https://ollama.com/install.sh | sh
# 2. Descarga un modelo
ollama pull llama3
# 3. Inicia el servidor
ollama serve
# 4. Inicializa (no se necesita clave API)
codereview --init ollama
export OPENAI_API_KEY="sk-..."
codereview --init openai
export ANTHROPIC_API_KEY="sk-ant-..."
codereview --init anthropic
La configuración se almacena en ~/.codereview/config.json:
{
"provider": "groq",
"model": "llama-3.3-70b-versatile",
"base_url": "https://api.groq.com/openai/v1",
"max_tokens": 2048,
"temperature": 0.2
}
Las claves API nunca se almacenan en el archivo de configuración. Se leen únicamente de las variables de entorno.
export CODEREVIEW_API_KEY="cualquier-clave" # Sobrescritura universal
export CODEREVIEW_MODEL="gpt-4" # Sobrescribe el modelo
codereview app.py --model gpt-4 --provider openai
Tu Código --> CLI codereview --> API LLM --> Salida Estructurada en Terminal
(archivo/diff) (constructor de prompt) (cualquier proveedor) (hallazgos codificados por colores)