Como usar o REA com agentes de programação: sua primeira investigação

Para usar o REA com um agente de programação, execute npx rea-agents@latest setup, aprove as alterações de configuração para o cliente escolhido e reinicie esse cliente. Em seguida, forneça ao agente um alvo de software local e um comportamento específico para investigar; peça o código relevante, as localizações no código-fonte e as limitações antes de solicitar qualquer implementação.

O REA é uma CLI e um servidor MCP de código aberto. Este artigo é um guia independente da comunidade; rea.tools e o repositório morluto/rea são as fontes oficiais do projeto.

Do que você precisa antes de instalar o REA?

O REA exige Node.js 22.x a partir de 22.19, Node.js 24.x a partir de 24.11 ou Node.js 26 e posteriores, além do npm. Node.js 23, 25 e versões de pré-lançamento estão fora da faixa de suporte documentada. Consulte o guia oficial de instalação ao configurar uma nova máquina.

Escolha um alvo que você possua ou tenha permissão para examinar. Um aplicativo JavaScript extraído ou um arquivo ASAR do Electron é um bom primeiro alvo, pois a análise estática de aplicativos do REA não exige Hopper, Ghidra ou IDA. A análise aprofundada de binários nativos usa um desses mecanismos e tem requisitos adicionais de plataforma e versão. O README do REA lista as categorias de alvos compatíveis e os pré-requisitos.

O que você quer fazer?	Ponto de partida recomendado	Entrada	Resultado
Pedir a um agente que explique um recurso	Configuração do MCP do REA	Caminho local do alvo e uma pergunta específica	Conclusões, evidências e investigação complementar
Inspecionar um aplicativo sem agente	CLI do REA	Diretório do aplicativo JavaScript extraído ou ASAR	Evidências estruturadas sobre o aplicativo
Inspecionar manualmente um layout da web ou pausar o JavaScript	Chrome DevTools	Página aberta no Chrome	Edição direta de DOM/CSS e controle de pontos de interrupção
Explorar por conta própria as funções e os grafos de um binário	Ghidra	Executável ou biblioteca compatível	Desmontagem e descompilação interativas e projeto de análise

O Chrome DevTools e o Ghidra oferecem interfaces robustas de inspeção direta. O REA é útil quando você quer que seu agente ajude a conduzir uma investigação e transforme conclusões selecionadas em uma explicação ou implementação. Veja nossa comparação com o Ghidra e nossa comparação com o Chrome DevTools.

Como conectar o REA a um agente de programação?

Execute o comando oficial de configuração em um terminal:

npx rea-agents@latest setup

Selecione o cliente desejado, revise a configuração exata e os caminhos da skill e aprove o plano. A configuração registra o servidor MCP local do REA e instala as instruções de investigação correspondentes. Reinicie o cliente indicado na mensagem de conclusão para que o agente em execução possa descobrir a conexão. A documentação oficial de configuração explica a prévia, os backups e os controles de escopo.

Para conferir o registro no Codex, use:

npx -y rea-agents@latest doctor --client codex --json

Substitua codex pelo ID do seu cliente compatível quando apropriado. Um resultado sem problemas do doctor verifica os arquivos de registro e os pré-requisitos; ele não prova que a sessão atual do agente se reconectou. Se o agente ainda não conseguir acessar o REA, reinicie ou reconecte o agente e inspecione o erro de conexão MCP. Instalar apenas a skill do skills.sh fornece instruções, não a conexão MCP. A orientação oficial para solução de problemas aborda essas diferenças.

O que seu primeiro prompt deve pedir ao REA para encontrar?

Escolha um comportamento observável, em vez de pedir a reconstrução de um aplicativo inteiro. Para um aplicativo que você tenha autorização para inspecionar, um prompt específico seria:

Use o REA para inspecionar /absolute/path/to/my-notes-app.
Explique como o aplicativo exporta notas em CSV.
Mostre os módulos relevantes, as localizações no código-fonte e as evidências.
Separe o comportamento confirmado daquilo que você não conseguir determinar.

Substitua o caminho pelo seu alvo real. O REA fornece resultados da investigação; o agente de programação os interpreta. Antes de aceitar a resposta, confira se o resultado identifica os arquivos-alvo, o código relevante e qualquer lacuna de cobertura. Uma explicação plausível sem uma localização que a sustente é uma hipótese a investigar mais a fundo.

Se o MCP estiver indisponível, a inspeção estática de JavaScript também pode ser executada diretamente:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/my-notes-app --json

O comando aceita um diretório de aplicativo extraído ou um ASAR e retorna um registro Evidence. Falhas de provedores de análise de código nativo em uma auditoria não impedem automaticamente esse fluxo de trabalho separado de JavaScript. As orientações do REA sobre prontidão por tarefa recomendam verificar a tarefa de que você realmente precisa.

Como conferir um resultado antes de recriar um recurso?

Transforme a explicação em uma pequena previsão. Para um exportador CSV, compare uma nota comum com uma nota contendo uma vírgula, uma aspa ou uma quebra de linha. Pergunte ao agente qual ramificação trata esses caracteres e como a saída prevista corresponde à exportação observada no aplicativo original. Mantenha a saída observada separada do código de substituição proposto pelo agente.

A investigação oficial do Notes usa uma exportação CSV para ensinar esse processo. O exemplo oficial do dinossauro ilustra um alvo diferente: o REA lê o script carregado pelo jogo no navegador, o agente identifica sua regra de aceleração e uma pequena reconstrução torna a velocidade ajustável. Esses são exemplos detalhados de autoria do projeto, não depoimentos de usuários independentes.

Quais são os limites de versão e privacidade?

O branch main do repositório pode documentar funcionalidades mais recentes que o pacote publicado no npm. @latest solicita a versão atual do npm; os registros persistentes do MCP ficam fixados na versão exata que realizou a configuração. Ao atualizar, refaça a configuração e reinicie o agente. Escolha os recursos com base na lista real de ferramentas e nos esquemas do servidor conectado, em vez de presumir que todos os recursos do branch main estão instalados. A distinção oficial entre a versão publicada e o branch main explica essa diferença.

O REA analisa os alvos na sua máquina. Os resultados das ferramentas são enviados ao seu agente de programação, cujo provedor de modelo tem sua própria política de dados. Revise o conteúdo de um resultado antes de compartilhá-lo, especialmente trechos de código-fonte, caminhos locais, requisições capturadas ou dados do aplicativo. As perguntas frequentes oficiais descrevem esse limite entre a análise local e o provedor do modelo.

Quais dúvidas surgem após a primeira investigação?

Posso usar o REA sem Hopper, Ghidra ou IDA?

Sim. A inspeção estática de JavaScript/Electron e .NET não exige um mecanismo de análise de código nativo. A análise aprofundada de código nativo exige. Escolha os pré-requisitos de acordo com o alvo, em vez de tratar todo provedor opcional como obrigatório.

O REA recupera o código-fonte original?

A análise de código nativo retorna assembly e pseudocódigo com conclusões de apoio. O pseudocódigo é uma representação para análise, não uma promessa de reproduzir o código-fonte original. O agente pode usar as conclusões para escrever uma nova implementação e testá-la.

Posso executar o REA sem uma assinatura de IA?

A CLI do REA pode executar fluxos de análise diretamente. O uso de um agente de programação envolve os requisitos de acesso do próprio cliente e os termos do provedor do modelo. A licença MIT do REA não fornece acesso a modelos nem uma licença de mecanismo comercial de análise.

O que devo fazer quando um comando falha?

Primeiro, confira os pré-requisitos documentados e atualize o REA. Para uma CLI instalada globalmente, rea update atualiza a instalação à qual ela pertence; para uma configuração de agente baseada em npx, execute novamente npx rea-agents@latest setup e reinicie o cliente. Se a falha persistir, informe a versão do REA, o sistema operacional, o tipo de alvo, o provedor, as etapas e a saída de erro no rastreador oficial de problemas.