Ferramenta CLI com inteligência artificial que revisa código em busca de vulnerabilidades de segurança, bugs e anti-padrões usando LLMs. Suporta provedores locais e na nuvem, diffs do git e integração com CI/CD.
Revisão de código com IA diretamente no seu terminal.
Um comando. Feedback instantâneo. Detecta vulnerabilidades de segurança, bugs e padrões ruins antes de chegarem à produção.
Instalar · Início Rápido · Uso · Provedores · Contribuir
O codereview envia seu código para um LLM e retorna uma revisão estruturada e codificada por cores diretamente no terminal — com classificações de gravidade, referências de linha e sugestões concretas de correção.
Sem navegador. Sem PR. Sem esperar por colegas. Apenas:
codereview app.py
| Severidade | O que encontra | Exemplo |
|---|---|---|
| 🔴 Crítico | Vulnerabilidades de segurança, perda de dados, travamentos | SQL injection, eval() em entrada do usuário, segredos codificados |
| 🟡 Aviso | Bugs, falta de tratamento de erros, condições de corrida | Divisão por zero, exceções não tratadas, vazamento de recursos |
| 🔵 Info | Melhorias de desempenho, padrões melhores | Alocações desnecessárias, falta de cache, consultas N+1 |
| ⚪ Estilo | Nomenclatura, formatação, documentação | Docstrings ausentes, nomenclatura inconsistente, código morto |
git clone https://github.com/jaydendancer12/ai-code-review.git
cd ai-code-review
./install.sh
Ou manualmente:
git clone https://github.com/jaydendancer12/ai-code-review.git
cd ai-code-review
pip install -e .
Todas as dependências (rich, requests) são instaladas automaticamente. Nada mais a configurar.
O codereview precisa de um LLM para analisar seu código. A opção gratuita mais rápida é o Groq — sem cartão de crédito, sem teste, apenas gratuito.
export GROQ_API_KEY="gsk_sua_chave_aqui"
Para torná-la permanente (para não precisar defini-la a cada sessão do terminal):
# Para zsh (padrão no Mac)
echo 'export GROQ_API_KEY="gsk_sua_chave_aqui"' >> ~/.zshrc
source ~/.zshrc
# Para bash (padrão no Linux)
echo 'export GROQ_API_KEY="gsk_sua_chave_aqui"' >> ~/.bashrc
source ~/.bashrc
codereview --init groq
codereview seu_arquivo.py
Pronto. Você está executando revisões de código com IA.
Primeira vez executando? Basta digitar codereview sem argumentos e ele o guiará por toda a configuração.
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 codigo_suspeito.py | codereview --stdin
codereview app.py --model gpt-4
codereview app.py --provider ollama
codereview --setup
O codereview funciona com qualquer API compatível com OpenAI. Escolha o que funciona para você:
export GROQ_API_KEY="gsk_sua_chave_aqui"
codereview --init groq
# 1. Instalar o Ollama
# Mac: Baixe de https://ollama.com
# Linux: curl -fsSL https://ollama.com/install.sh | sh
# 2. Baixar um modelo
ollama pull llama3
# 3. Iniciar o servidor
ollama serve
# 4. Inicializar (nenhuma chave de API necessária)
codereview --init ollama
export OPENAI_API_KEY="sk-..."
codereview --init openai
export ANTHROPIC_API_KEY="sk-ant-..."
codereview --init anthropic
A configuração é armazenada em ~/.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
}
As chaves de API nunca são armazenadas no arquivo de configuração. Elas são lidas apenas de variáveis de ambiente.
export CODEREVIEW_API_KEY="qualquer-chave" # Substituição universal
export CODEREVIEW_MODEL="gpt-4" # Substituir modelo
codereview app.py --model gpt-4 --provider openai
Seu Código --> CLI codereview --> API LLM --> Saída Estruturada no Terminal
(arquivo/diff) (construtor de prompt) (qualquer provedor) (achados com código de cores)