Impostare REA .

Connetti REA al tuo agente di codifica o ispeziona un'app locale dal tuo terminale.

Avrai bisogno di Node.js 22 (22.19+), 24 (24.11+) o 26+. npm viene fornito con Node.js.

Non ho Node.js, o non sicuro?

Aprire un terminale e controllare:

Terminale
node -v
npm -v

Se node -v stampa v22.19+, v24.11+ o v26+, sei pronto. Se stampa una versione precedente o" non riconosciuto " / "comando non trovato", installare Node.js 24 LT:

Windows (PowerShell)

Windows PowerShell
winget install OpenJS.NodeJS.LTS

Digitare Y se viene chiesto di accettare i termini. Chiudere PowerShell, aprirlo di nuovo, quindi eseguire node -v.

Se PowerShell in seguito dice "l'esecuzione di script è disabilitata su questo sistema" quando corri npx, esegua questo una volta e riprova:

Windows PowerShell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

macOS

Se si utilizza Homebrew :

macOS · Homebrew
brew install node

Altrimenti:

macOS
curl -fsSL https://fnm.vercel.app/install | bash

Chiudere il terminale, aprirlo di nuovo, quindi:

macOS
fnm install 24
fnm default 24

Linux

Linux
curl -fsSL https://fnm.vercel.app/install | bash

L'installatore ha bisogno curl e unzip (su Debian / Ubuntu: sudo apt install curl unzip). Chiudere il terminale, aprirlo di nuovo, quindi:

Linux
fnm install 24
fnm default 24

La tua distribuzione nodejs il pacchetto è spesso più vecchio di 22.19, quindi controlla node -v se invece lo usi.

Preferisci un normale installatore? Scarica la versione LTS da nodejs.org.

Connetti il tuo agente di codifica

Esegui setup per connettere REA al tuo agente di codifica. Le scelte del client includono Claude Code, Codex , Cursor , Gemini CLI , Windsurf , Grok Build e altri client MCP supportati. Il connettore di Grok Bot viene aggiunto dalla sua chat.

Nuovi agenti di codifica?

Un agente di codifica è un assistente AI che funziona sul computer anziché in una scheda del browser. Può leggere file ed eseguire comandi e chiede prima di apportare modifiche. REA fornisce strumenti di reverse engineering it.

Se non ne hai ancora uno, scegli uno, segui la sua pagina di installazione e accedi:

  • Claude Code di Anthropic . Ha bisogno di un piano Claude pagato.
  • Codex di OpenAI . Accedi con il tuo account ChatGPT.
  • OpenCode , fonte aperta. Connetti il fornitore di modelli di tua scelta.

Quindi aprilo e copia il prompt qui sotto. L'agente esegue la configurazione di REA e ti mostra il piano prima di cambiare qualsiasi cosa.

Il tuo agente di codifica

Installa REA e collegalo a questo agente di programmazione usando npx rea-agents@latest setup. Mostrami prima le modifiche previste e attendi la mia approvazione. Poi verifica l’installazione.

O eseguire l'installazione da soli
Come faccio ad aprire un terminale?
  • Windows : aprire il menu Start, digitare PowerShell e premere Invio.
  • macOS : premere ⌘ Space, tipo Terminale e premere Invio.
  • Linux : premere Ctrl Alt T sulla maggior parte dei desktop.

Incolla un comando con Ctrl V ( macOS : ⌘ V; Terminali Linux: Ctrl Shift V), quindi premere Invio.

Terminale
npx rea-agents@latest setup

Scegli il tuo cliente e rivedere il piano di installazione. REA aggiunge la sua connessione MCP e l'abilità di indagine corrispondente, mantenendo un backup della configurazione esistente. Chiede prima di applicare le modifiche.

Riavvia il client al termine dell'installazione.

Come faccio a riavviare il mio cliente?

Applicazioni desktop (Claude Desktop, Cursor , Windsurf , VS Code ): esci completamente dall'app, quindi aprila di nuovo. Chiudere la finestra non basta. Su macOS premere ⌘ Q; su Windows, esci anche dall'icona del vassoio se ce n'è uno.

Agenti terminali (Claude Code , Codex , Gemini CLI ): uscire dalla sessione e riavviarla.

Dai al tuo agente un percorso di destinazione e una domanda specifica. Per un'app JavaScript o Electron, potresti iniziare con:

Guarda /absolute/path/to/app e scopri come esporta i dati. Mostra i punti di ingresso, le chiamate e le dipendenze coinvolte, con le posizioni di origine per i risultati.

Sostituisci il percorso con il tuo target locale.

Come ottengo il percorso completo di una cartella?
  • Windows : in Esplora file, fare clic con il pulsante destro del mouse sulla cartella e scegliere Copia come percorso. Su Windows 10, tenere premuto Maiusc mentre si fa clic con il pulsante destro del mouse.
  • macOS : nel Finder, fare clic destro sulla cartella, tenere premuto Opzione e scegliere Copia " ... " come percorso.
  • Qualsiasi sistema: trascinare la cartella in una finestra di terminale e il suo percorso appare.

In un terminale, metti le virgolette attorno a un percorso che contiene spazi.

Utilizzare il CLI

Analizzare una cartella dell'applicazione JavaScript o Electron o un archivio ASAR senza eseguire l'app:

Analisi statica delle applicazioni
npx -y rea-agents@latest analyze-javascript-application \
  /absolute/path/to/app --json

Sostituire il percorso con la directory dell'app estratta o .asar file. Su Windows, un percorso come "D:/apps/example" funziona qui.

Dove trovo un'app .file asar?

Electron apps di solito tenerlo in un resources cartella:

  • Windows : C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar
  • macOS : /Applications/<App>.app/Contents/Resources/app.asar (fare clic con il pulsante destro del mouse sull'app e scegliere Mostra il contenuto della confezione)
  • Linux : spesso /opt/<App>/resources/app.asar

Alcune app si installano altrove. Cerca nella cartella dell'app per app.asar.

Il risultato identifica l'app, mostra le connessioni tra i moduli e fornisce le loro posizioni di origine. Le connessioni che REA non può risolvere sono contrassegnate nel risultato.

Se vuoi un permanente rea comando nella tua shell:

Installare il CLI
npm install --global rea-agents

Continuare con la guida all'applicazione JavaScript

Impostare l'analisi dei programmi di codice macchina

I programmi di codice macchina necessitano di uno strumento di analisi locale. Scegli e configura uno di seguito, quindi assegna a REA l'eseguibile o la libreria.

Scegli uno strumento: Ghidra, Hopper o IDA

Ghidra

Utilizzare un Ghidra 12.1 esistente.installazione x e un JDK 21 a 64 bit o più recente su Linux o macOS, su x64 o arm64. L'installazione di Ghidra richiede un decompiler nativo per l'architettura host. Impostare i percorsi prima di eseguire setup:

Collegare l'installazione Ghidra
Collegamento di Ghidra · macOS / Linux
export GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.1.4_PUBLIC
export JAVA_HOME=/absolute/path/to/jdk-21
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

Sostituisci entrambi i percorsi con le installazioni esistenti. Setup li controlla e registra le impostazioni valide per il client selezionato. Su Linux arm64, potrebbe essere necessario compilare separatamente il decompilatore nativo di Ghidra.

Collegare Ghidra su Windows

Windows x64 ha il supporto sperimentale di sola lettura per applicazioni native x86 e x64 PE e DLL su unità NTFS locali fisse. Utilizzare un Ghidra 12.1 esistente.x installazione e un JDK 21 a 64 bit o più recente:

Connessione Ghidra * PowerShell Windows
$env:GHIDRA_INSTALL_DIR = "C:/tools/ghidra_12.1.4_PUBLIC"
$env:JAVA_HOME = "C:/tools/jdk-21"
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup

Sostituire i due percorsi con le installazioni, quindi rivedere il piano di installazione.

Hopper

Collegare Hopper su macOS o Linux . Eseguire il comando setup sopra; rileva un'installazione esistente o offre un piano di installazione per l'approvazione.

Su macOS, completa la scelta di prima esecuzione di Hopper della modalità demo o dell'attivazione della licenza prima di un'analisi automatica.

IDA

Le configurazioni IDA verificate utilizzano Windows, con una registrazione MCP esistente per una GUI collegata o un database headless. L'analisi senza testa Linux e macOS rimane non verificata.

Collegare una registrazione IDA MCP esistente

Mantenere il funzionamento del server upstream command, args e facoltativo env in un file JSON. Un esistente mcpServers oggetto con un ida-pro-mcp si accetta anche l'ingresso. Punta REA su quel file prima dell'installazione:

Connessione IDA * PowerShell Windows
$env:REA_IDA_MCP_CONFIG = "C:/analysis/ida-mcp.json"
$env:REA_ANALYSIS_PROVIDER = "ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup

Il profilo allegato utilizza gli strumenti 1.4.0 legacy a monte con il binario originale già aperto in IDA . Il profilo headless utilizza l'API upstream database-supervisor e una registrazione con "mode": "headless"; verifica reale copre un supervisore IDA 9.3 Windows x64. Il medico controlla la registrazione senza avviare IDA .

Dare a REA il percorso eseguibile originale, con --provider ida in una query CLI. Per un agente, includere REA_IDA_MCP_CONFIG nell'ambiente di registrazione REA e selezionare IDA quando si apre il binario.

Per una configurazione Ghidra esistente, ispezionare una funzione con:

Analisi delle funzioni
npx -y rea-agents@latest function /absolute/path/to/program main \
  --provider ghidra --json

Sostituire main con il nome della funzione o l'indirizzo che si desidera ispezionare.

Come funzionano le sessioni di analisi dei programmi di codice macchina

Ogni comando CLI importa e analizza il binario, quindi chiude la sua sessione. Le query MCP dell'agente riutilizzano il binario importato mentre la sessione è aperta.

Seguire un esempio di analisi dei programmi di codice macchina per vedere come il risultato della funzione porta a un calcolo recuperato.

Ottenere aiuto

Se il tuo agente non vede REA

Riavviare o ricollegare il client dopo l'installazione. Controlla la sua connessione REA con doctor; per Codex :

Controlla un cliente
npx -y rea-agents@latest doctor --client codex --json

Se un fornitore ha bisogno di attenzione

Controlla il provider che stai utilizzando. Per Ghidra :

Controllare un provider
npx -y rea-agents@latest doctor --provider ghidra --json

Il rapporto fornisce il controllo non riuscito e un passo successivo suggerito.

Cima