Skip to main content

airev

CLI para revisão de código automatizada com IA. Analisa diffs de branches Git e identifica problemas de segurança, performance, bugs e vazamentos de recursos.

Funcionalidades

  • Análise de diff inteligente: Compara sua branch com a branch base e analisa apenas o código modificado
  • Context backtracking: Identifica automaticamente funções que chamam ou são chamadas pelo código modificado
  • Análise estática determinística: Complementa a IA com linters locais (ruff/pyflakes para Python, tsc/eslint para JS/TS, go build para Go) — variáveis não declaradas e erros de compilação são detectados com 100% de confiança
  • Modo thorough: Uma passada de IA dedicada por categoria (segurança, performance, bugs) para máxima cobertura
  • Múltiplos runners de IA: Suporte a Gemini CLI, GitHub Copilot CLI e Claude Code CLI
  • Output estruturado: Resultados em terminal colorido ou JSON para integração com CI/CD
  • Internacionalização: Suporte a português (pt-br) e inglês (en)
  • Categorização de findings: Severidade (CRITICAL, WARNING, INFO) e categoria (security, performance, bug, resource-leak)

Instalação

Requisitos

Via pipx (Recomendado)

# Instala o pipx se ainda não tiver
pip install pipx
pipx ensurepath

# Instala o airev
pipx install airev

Via pip

pip install airev

Desenvolvimento local

# Clone o repositório
git clone https://github.com/tarcisiojr/airev.git
cd airev

# Instala em modo desenvolvimento
pip install -e ".[dev]"

Atualização

O airev verifica automaticamente por novas versões e notifica quando há atualizações disponíveis.

# Atualiza para a versão mais recente
airev upgrade

# Ou manualmente
pipx upgrade airev
# ou
pip install --upgrade airev

Para desabilitar a verificação automática:

export AIREV_NO_UPDATE_CHECK=1

Uso

Comando básico

# Analisa a branch atual contra main
airev review --base main

# Analisa contra develop usando Copilot
airev review --base develop --runner copilot

# Output em JSON para CI/CD
airev review --base main --json-output

# Modo silencioso (sem animações)
airev review --base main --no-progress

# Em inglês
airev review --base main --lang en

Opções do comando review

Opção Descrição
--base, -b Branch base para comparação (obrigatório)
--runner, -r Runner de IA: gemini (padrão), copilot ou claude
--json-output, -j Retorna resultado em JSON
--workdir, -w Diretório do repositório (padrão: atual)
--no-progress Desabilita animações (modo CI)
--progress Força animações mesmo em CI
--lang, -l Idioma: pt-br (padrão) ou en
--min-confidence, -c Exibe apenas findings com confidence >= N (padrão: 7). O CLI informa quantos findings foram ocultados pelo filtro
--thorough, -T Análise profunda: uma passada de IA por categoria. Mais lento, maior cobertura

Listar runners disponíveis

airev runners

Runners de IA

Gemini CLI (padrão)

Instale o Gemini CLI:

npm install -g @google/gemini-cli
# ou
brew install gemini-cli

GitHub Copilot CLI

Instale o Copilot CLI standalone:

npm install -g @github/copilot-cli
# ou
brew install github/gh/copilot-cli
# ou
winget install GitHub.CopilotCLI

Claude Code CLI

Instale o Claude Code:

npm install -g @anthropic-ai/claude-code

Use com:

airev review --base main --runner claude

Output

Terminal

O output no terminal inclui:

  • Lista de arquivos modificados com estatísticas de linhas
  • Dependências identificadas (callers/callees)
  • Findings categorizados por severidade com cores
  • Resumo final com contagem por tipo

JSON

Com --json-output, o resultado segue a estrutura:

{
  "branch": "feature/x",
  "base": "main",
  "files_analyzed": 5,
  "findings": [
    {
      "file": "src/auth.py",
      "line": 42,
      "severity": "CRITICAL",
      "category": "security",
      "title": "SQL Injection",
      "description": "Query concatenada sem sanitização",
      "suggestion": "Use prepared statements"
    }
  ],
  "summary": {
    "total": 3,
    "critical": 1,
    "warning": 2,
    "info": 0
  }
}

Integração com CI/CD

GitHub Actions

- name: Code Review
  run: |
    pip install airev
    airev review --base main --no-progress --json-output > review.json

- name: Check Critical Findings
  run: |
    CRITICAL=$(jq '.summary.critical' review.json)
    if [ "$CRITICAL" -gt 0 ]; then
      echo "Found $CRITICAL critical issues!"
      exit 1
    fi

Telemetria

O airev coleta dados anônimos de uso para ajudar a entender como a ferramenta é utilizada e melhorar a experiência. A telemetria é habilitada por padrão e pode ser desabilitada a qualquer momento.

O que é coletado

Apenas metadados anônimos e não-sensíveis:

  • Runner utilizado (gemini, copilot)
  • Flags de configuração (valores booleanos)
  • Contagens numéricas (arquivos analisados, findings por severidade)
  • Duração do review
  • Tipo de erro em caso de falha (enum fixo, sem mensagens de erro)
  • Versão do airev

O que não é coletado

  • Código-fonte ou diffs
  • Nomes de branches ou caminhos de arquivo
  • Descrições de PR ou mensagens de erro
  • Qualquer informação que identifique o projeto analisado

Identidade

Um UUID v4 aleatório é gerado na primeira execução e salvo em ~/.cache/airev/anonymous_id. Este ID é completamente anônimo e não pode ser associado a nenhum dado pessoal.

Opt-out

Para desabilitar a telemetria:

export AIREV_NO_TELEMETRY=1

Quando desabilitada, nenhum evento é enviado, nenhuma conexão de rede é feita, e o SDK de analytics não é sequer importado.

Desenvolvimento

Executar testes

pytest

Executar com cobertura

pytest --cov=code_reviewer

Verificar código

python -m py_compile src/code_reviewer/*.py

Arquitetura

src/code_reviewer/
├── cli.py              # Entry point e comandos Click
├── diff_parser.py      # Parser de git diff
├── context_builder.py  # Backtracking de dependências
├── prompt_builder.py   # Construção do prompt para IA
├── static_analysis.py  # Camada determinística (ruff, tsc, eslint, go build)
├── response_parser.py  # Parser da resposta da IA
├── models.py           # Modelos Pydantic
├── formatters/
│   ├── terminal.py     # Formatação colorida com rich
│   └── progress.py     # Reporter de progresso
├── analytics/
│   ├── __init__.py     # API pública: track_event(), shutdown_analytics()
│   ├── client.py       # Client PostHog com lazy init e flush assíncrono
│   └── identity.py     # UUID anônimo persistido
├── runners/
│   ├── base.py         # Interface AIRunner
│   ├── gemini.py       # Runner Gemini CLI
│   └── copilot.py      # Runner Copilot CLI
├── i18n/               # Sistema de internacionalização
├── locales/            # Arquivos de tradução (YAML)
└── prompts/            # Templates de prompt

Licença

MIT

Metadata

Release files for airev 1.11.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for airev 1.11.1
File Size Uploaded Provenance Actions
airev-1.11.1.tar.gz 73.4 kB Without provenance Details for airev-1.11.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for airev 1.11.1
File Interpreter ABI Platform Actions
airev-1.11.1-py3-none-any.whl Python 3 none any Details for airev-1.11.1-py3-none-any.whl

Total release size: 136.2 kB

Release files / airev-1.11.1.tar.gz

Download URL airev-1.11.1.tar.gz
Size 73.4 kB
Tags Source
SHA-256 checksum
How to use checksums
2dcbf38f70b6b309d92e841e11207b25d863a84c29c610a68aa7d460cc49f5c7
BLAKE2b-256 checksum
How to use checksums
323af52e34e6444eeb0ec4968d691d76d5509206ad98e1fd6f8a743eabf186e3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / airev-1.11.1-py3-none-any.whl

Download URL airev-1.11.1-py3-none-any.whl
Size 62.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b1f0f1861087fdd8c201708760fa8ee470f4b50a1395f9bc4605bfdbf4ee7d6b
BLAKE2b-256 checksum
How to use checksums
dc70c3095f1fa1ebec8e6a4317645a6112cc001c25a0fc2b9a1a5cba497ac44a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Security for airev 1.11.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page