Come usare REA con gli agenti di programmazione: la tua prima indagine

Per usare REA con un agente di programmazione, esegui npx rea-agents@latest setup, approva le modifiche alla configurazione per il client scelto e riavvia quel client. Poi indica all'agente un software locale da analizzare e un comportamento specifico su cui indagare; chiedi il codice pertinente, le posizioni nei sorgenti e i limiti prima di chiedergli di costruire qualcosa.

REA è una CLI e un server MCP open source. Questo articolo è una guida indipendente della community; rea.tools e il repository morluto/rea sono le fonti ufficiali del progetto.

Che cosa serve prima di installare REA?

REA richiede Node.js 22.x a partire da 22.19, Node.js 24.x a partire da 24.11, oppure Node.js 26 e successivi, oltre a npm. Node.js 23, 25 e le versioni preliminari non rientrano nell'intervallo di supporto documentato. Consulta la guida ufficiale all'installazione quando configuri un nuovo computer.

Scegli un software di tua proprietà o che hai il permesso di esaminare. Un'applicazione JavaScript estratta o un archivio ASAR di Electron sono utili come primo oggetto di analisi, perché l'analisi statica delle applicazioni di REA non richiede Hopper, Ghidra o IDA. L'analisi approfondita dei binari nativi usa uno di questi motori e ha requisiti aggiuntivi di piattaforma e versione. Il README di REA elenca le famiglie di oggetti di analisi supportate e i prerequisiti.

Che cosa vuoi fare?	Punto di partenza consigliato	Input	Risultato
Chiedere a un agente di spiegare una funzionalità	Configurazione MCP di REA	Percorso locale del software da analizzare e domanda circoscritta	Conclusioni, evidenze e ulteriori indagini
Esaminare un'app senza un agente	CLI di REA	Directory di un'app JavaScript estratta o ASAR	Evidenze strutturate sull'applicazione
Esaminare manualmente un layout web o mettere in pausa JavaScript	Chrome DevTools	Pagina aperta in Chrome	Modifica diretta di DOM/CSS e controllo dei breakpoint
Esplorare in prima persona le funzioni e i grafi di un binario	Ghidra	Eseguibile o libreria supportati	Disassemblaggio, decompilazione e progetto di analisi interattivi

Chrome DevTools e Ghidra offrono valide interfacce di analisi diretta. REA è utile quando vuoi che il tuo agente ti aiuti a orientarti in un'indagine e a trasformare conclusioni selezionate in una spiegazione o in un'implementazione. Consulta il nostro confronto con Ghidra e il confronto con Chrome DevTools.

Come si collega REA a un agente di programmazione?

Esegui il comando ufficiale di configurazione in un terminale:

npx rea-agents@latest setup

Seleziona il client desiderato, esamina la configurazione esatta e i percorsi delle skill, poi approva il piano. La configurazione registra il server MCP locale di REA e installa le istruzioni di indagine corrispondenti. Riavvia il client indicato nel messaggio di completamento, in modo che l'agente in esecuzione possa rilevare la connessione. La documentazione ufficiale della configurazione spiega l'anteprima, i backup e i controlli dell'ambito.

Per controllare la registrazione di Codex, usa:

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

Sostituisci codex con l'ID del tuo client supportato quando opportuno. Un esito positivo di doctor verifica i file di registrazione e i prerequisiti; non dimostra che la sessione attuale dell'agente si sia riconnessa. Se l'agente continua a non vedere REA, riavvialo o riconnettilo ed esamina l'errore della sua connessione MCP. Installare soltanto la skill da skills.sh fornisce le istruzioni, non la connessione MCP. La guida ufficiale alla risoluzione dei problemi illustra queste differenze.

Che cosa dovrebbe chiedere di trovare a REA il tuo primo prompt?

Scegli un comportamento osservabile, anziché richiedere la ricostruzione di un'intera applicazione. Per un'applicazione che sei autorizzato a esaminare, un prompt circoscritto è:

Usa REA per esaminare /absolute/path/to/my-notes-app.
Spiega come l'applicazione esporta le note in formato CSV.
Mostra i moduli pertinenti, le posizioni nei sorgenti e le evidenze.
Distingui il comportamento confermato da tutto ciò che non puoi determinare.

Sostituisci il percorso con quello del software che vuoi davvero analizzare. REA fornisce risultati di indagine; l'agente di programmazione li interpreta. Prima di accettare la risposta, controlla se il risultato identifica i file analizzati, il codice pertinente ed eventuali lacune nella copertura. Una spiegazione plausibile senza una posizione a sostegno è un'ipotesi da approfondire.

Se MCP non è disponibile, l'analisi statica di JavaScript può essere eseguita anche direttamente:

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

Il comando accetta la directory di un'applicazione estratta o un ASAR e restituisce un record Evidence. Gli errori dei provider nativi durante un audit non impediscono automaticamente questo flusso di lavoro JavaScript separato. Le indicazioni di REA sui controlli di operatività circoscritti consigliano di controllare l'attività di cui hai effettivamente bisogno.

Come controllare un risultato prima di ricostruire una funzionalità?

Trasforma la spiegazione in una piccola previsione. Per un esportatore CSV, confronta una nota normale con una nota contenente una virgola, una virgoletta o un ritorno a capo. Chiedi all'agente quale ramo gestisce quei caratteri e come l'output previsto corrisponde all'esportazione osservata nell'applicazione originale. Mantieni distinto l'output osservato dal codice sostitutivo proposto dall'agente.

L'indagine ufficiale su Notes usa un'esportazione CSV per insegnare questo processo. L'esempio ufficiale del dinosauro illustra un oggetto di analisi diverso: REA legge lo script caricato dal gioco nel browser, l'agente ne identifica la regola di accelerazione e una piccola ricostruzione rende regolabile la velocità. Si tratta di esempi svolti realizzati dal progetto, non di testimonianze di utenti indipendenti.

Quali sono i limiti relativi alle versioni e alla privacy?

Il ramo main del repository può documentare funzionalità più recenti del pacchetto npm pubblicato. @latest richiede la versione npm attuale; le registrazioni MCP persistenti sono vincolate alla versione esatta che ha eseguito la configurazione. Quando aggiorni, ripeti la configurazione e riavvia l'agente. Scegli le funzionalità dall'elenco effettivo degli strumenti e dagli schemi del server connesso, anziché supporre che ogni funzionalità del ramo main sia installata. La distinzione ufficiale tra versione pubblicata e ramo main spiega questa differenza.

REA analizza il software sul tuo computer. I risultati degli strumenti vengono inviati al tuo agente di programmazione, il cui fornitore del modello ha una propria informativa sui dati. Esamina ciò che contiene un risultato prima di condividerlo, in particolare frammenti di codice sorgente, percorsi locali, richieste acquisite o dati dell'applicazione. Le domande frequenti ufficiali descrivono questo confine tra analisi locale e fornitore del modello.

Quali domande sorgono dopo la prima indagine?

Posso usare REA senza Hopper, Ghidra o IDA?

Sì. L'analisi statica di JavaScript/Electron e .NET non richiede un motore di analisi nativa. L'analisi nativa approfondita lo richiede. Scegli i prerequisiti in funzione dell'oggetto dell'analisi, senza considerare obbligatorio ogni provider opzionale.

REA recupera il codice sorgente originale?

L'analisi nativa restituisce assembly e pseudocodice con conclusioni a sostegno. Lo pseudocodice è una rappresentazione di analisi, non una promessa di riprodurre il codice sorgente originale. L'agente può usare le conclusioni per scrivere una nuova implementazione e verificarla.

Posso eseguire REA senza un abbonamento a un servizio di IA?

La CLI di REA può eseguire direttamente i flussi di lavoro di analisi. Usare un agente di programmazione comporta i requisiti di accesso propri di quel client e le condizioni del fornitore del modello. La licenza MIT di REA non fornisce accesso ai modelli né una licenza per un motore di analisi commerciale.

Che cosa devo fare quando un comando non riesce?

Controlla i prerequisiti documentati e aggiorna prima REA. Per una CLI installata globalmente, rea update aggiorna l'installazione a cui appartiene; per una configurazione dell'agente basata su npx, esegui nuovamente npx rea-agents@latest setup e riavvia il client. Se l'errore persiste, segnala la versione di REA, il sistema operativo, il tipo di software analizzato, il provider, i passaggi e l'output dell'errore tramite il sistema ufficiale di segnalazione dei problemi.