1. Prepara tu ordenador
Usa el ordenador donde están los archivos que quieres investigar. Un agente de programación local puede leer esos archivos y ejecutar herramientas por ti.
¿Cómo abro una terminal?
- Windows : abra el menú Inicio, escriba PowerShell y presione Entrar.
- macOS: pulsa ⌘ Space, escribe Terminal y pulsa Enter.
- Linux: pulsa Ctrl Alt T en la mayoría de los escritorios.
Pegue un comando con Ctrl V ( macOS : ⌘ V; Terminales Linux: Ctrl Shift V), luego presione Entrar.
Los comandos se introducen en la terminal. Las instrucciones etiquetadas como «Tu agente de programación» se escriben en el chat del agente.
Necesitarás Node.js 22 (22.19+), 24 (24.11+) o 26+. npm viene con Node.js.
No tengo Node.js, ¿ o no estás seguro?
Abra una terminal y verifique:
node -v
npm -v
Si node -v muestra v22.19+, v24.11+ o v26+, ya puedes continuar. Si muestra una versión anterior o "not recognized" / "command not found", instala Node.js 24 LTS:
Windows (PowerShell)
winget install --exact --id OpenJS.NodeJS.LTS
Escriba Y si se le pide que acepte los términos. Cierre PowerShell, ábralo nuevamente y luego ejecute node -v.
Descarga el instalador de Node.js si winget no está disponible.
Si más adelante PowerShell muestra "running scripts is disabled on this system" al ejecutar npx, usa npx.cmd en su lugar. Para npm, usa npm.cmd:
npx.cmd rea-agents@latest setup
macOS
Para una primera instalación, descarga el instalador de Node.js 24 LTS para macOS (.pkg), ábrelo y sigue sus instrucciones. Después, vuelve a abrir Terminal.
¿Ya usas Homebrew?
brew install node
Linux
Instala primero curl y unzip si faltan. En Debian o Ubuntu, ejecuta sudo apt install curl unzip; en otras distribuciones, usa tu gestor de paquetes.
curl -fsSL https://fnm.vercel.app/install | bash
Cierra la terminal, ábrela de nuevo y después ejecuta:
fnm install 24
fnm use 24
fnm default 24
Tu propia distribución nodejs el paquete suele ser anterior a 22.19, así que verifique node -v si lo usas en su lugar.
¿Prefiere un instalador regular? Descargue la versión LTS desde nodejs.org.
Crea una carpeta de trabajo para tu agente
En la terminal, crea una carpeta para el ejercicio y entra en ella:
mkdir rea-work
cd rea-work
Mantén esta terminal abierta para el siguiente paso. Si ya tienes una carpeta de trabajo, abre esa en su lugar.
2. Elige un agente de programación
Tu agente es la IA con la que hablas. REA le proporciona las herramientas de inspección. Elige una aplicación cliente de la lista y abre sus instrucciones si nunca la has usado.
Codex · usa tu cuenta de ChatGPT
Instala Codex con el comando de tu sistema operativo:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Tras la instalación, vuelve a abrir la terminal y entra en la carpeta de trabajo. Después, inicia Codex:
codex
Elige «Sign in with ChatGPT», inicia sesión en el navegador y vuelve a la terminal. Cuando aparezca el cuadro de mensajes, continúa con el paso 3.
Cursor, Windsurf o VS Code · usa un editor
- Instala el editor para tu sistema operativo e inicia sesión.
- Abre la carpeta rea-work que creaste en el paso 1.
- Abre el chat de IA y elige el modo Agent. En Windsurf o Devin Desktop, abre el chat del agente; en VS Code, configura primero GitHub Copilot.
Configuración de Cursor · Configuración de Windsurf / Devin Desktop · Configuración de VS Code y Copilot
Claude Code · usa tu cuenta de Claude
Instala con el comando de tu sistema operativo:
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.sh | bash
Vuelve a abrir la terminal, entra en tu carpeta de trabajo y ejecuta claude. Sigue las instrucciones de inicio de sesión. Para acceder necesitas una suscripción de Claude compatible o una cuenta de API configurada.
Claude Desktop · usa un chat de escritorio
Instala Claude Desktop en Windows o macOS e inicia sesión. Ciérralo por completo y después ejecuta este comando en una terminal que hayas abierto fuera de Claude:
npx rea-agents@latest setup --client claude_desktop
Revisa y aprueba el plan, vuelve a abrir Claude y comprueba la conexión en el paso 3.
Descargar Claude Desktop · Detalles de conexión de Claude Desktop
OpenCode · elige un modelo de IA
npm install --global opencode-ai
Ejecuta opencode en tu carpeta de trabajo. Usa /connect en su chat para conectar tu cuenta de modelos y después elige un modelo.
Todos los clientes compatibles y sus identificadores de configuración
La versión 6.4.0 de npm admite los clientes de abajo. Usa el identificador con --client cuando quieras elegir un cliente de forma explícita.
| Cliente | ID de configuración |
|---|---|
| Claude Code | claude_code |
| Claude Desktop | claude_desktop |
| Codex | codex |
| Cursor | cursor |
| Gemini CLI | gemini_cli |
| Windsurf | windsurf |
| Devin | devin |
| OpenCode | opencode |
| Antigravity | antigravity |
| GitHub Copilot CLI | copilot_cli |
| Command Code | commandcode |
| Qwen Code | qwen_code |
| VS Code | vscode |
| Grok Build | grok_build |
| OMP | omp |
| Pi | pi |
| Hermes | hermes |
Qoder (qoder), Factory Droid (droid), Trae (trae), ZCode (zcode) y DeepSeek Harness (dsh) están disponibles en la rama main del repositorio. Usa una compilación del código fuente o una versión publicada que incluya esas integraciones.
Configuración de clientes y solución de problemas · Disponibilidad en versiones publicadas
Grok Bot · conecta en su ordenador alojado
En el chat de Grok Bot, pídele que añada un servidor MCP personalizado llamado rea ejecutando este comando en el ordenador del bot:
npx -y rea-agents@6.4.0 mcp
3. Conecta REA
Copia este prompt en tu agente de programación:
Instala REA y conéctalo a este agente de programación usando npx rea-agents@latest setup. Muéstrame los cambios propuestos y espera mi aprobación antes de aplicarlos. Después, verifica la instalación.
O ejecute la configuración usted mismo
npx rea-agents@latest setup
Para un cliente concreto, añade su identificador de configuración:
npx rea-agents@latest setup --client codex
Si npm pide descargar el paquete, escribe y y pulsa Enter. En la lista de clientes de REA, usa las flechas para moverte, Espacio para seleccionar tu cliente y Enter para continuar.
Elija su cliente y revise el plan de configuración. REA agrega su conexión MCP y la habilidad de investigación correspondiente, manteniendo una copia de seguridad de la configuración existente. Pregunta antes de aplicar los cambios.
MCP es la conexión que permite a tu agente llamar a REA. La skill le proporciona un flujo de trabajo para investigar software.
Para el primer ejercicio puedes omitir la instalación opcional de Hopper. Reinicia tu cliente cuando termine la configuración.
¿Cómo reinicio mi cliente?
Aplicaciones de escritorio (Escritorio Claude, Cursor , Windsurf , VS Code): salga de la aplicación por completo y luego ábrala nuevamente. Cerrar la ventana no es suficiente. En prensa macOS ⌘ Q; en Windows, también salga del icono de la bandeja, si lo hay.
Agentes terminales ( Claude Code, Codex, Gemini CLI ): salga de la sesión y vuelva a iniciarla.
npx -y rea-agents@latest doctor --client codex --json
Sustituye codex por el identificador de configuración de tu cliente. Una comprobación correcta muestra "healthy": true. Después, pide a tu agente:
Comprueba que REA está conectado y muéstrame qué herramientas de REA puedes usar.
4. Prueba tu primera investigación
El ejemplo es una aplicación Electron de seis archivos con un Notas de exportación botón. Su agente puede inspeccionar su código sin instalar ni iniciar Electron .
Descargar https://rea.tools/examples/notes-example.zip en una nueva carpeta de ejemplo y descomprímala. Use REA para averiguar qué sucede cuando hago clic en Exportar notas. Mostrar dónde notes.csv está escrito, qué campos contiene y los archivos y líneas relevantes.
Busque una breve explicación con referencias de archivos y líneas:
El botón envía un
notes:exportmensaje. El proceso principal formatea las notas como CSV y escribenotes.csven la carpeta de descargas del usuario. Las columnas sonidytitle.
Comprueba una predicción en el ejercicio guiado →
Descarga el ejemplo tú mismo o usa tu propia aplicación
Si su agente no puede descargar archivos, descomprímalo usted mismo. Dale el camino al notes-example carpeta y la misma pregunta de exportación.
Usa REA para inspeccionar la aplicación en
/absolute/path/to/app. Averigua cómo exporta los datos y muestra los archivos y las líneas relevantes.
¿Cómo obtengo la ruta completa de una carpeta?
- Windows : en el Explorador de archivos, haga clic con el botón derecho en la carpeta y elija Copiar como ruta. En Windows 10, mantenga presionada la tecla Mayús mientras hace clic con el botón derecho.
- macOS: en Finder, haz clic derecho en la carpeta, mantén pulsada la tecla Opción y elige Copiar «…» como nombre de ruta.
- Cualquier sistema: arrastre la carpeta a una ventana de terminal y aparecerá su ruta.
En una terminal, coloque comillas alrededor de una ruta que contenga espacios.
Analiza otro tipo de software
Elige la sección correspondiente a tu objetivo. Un proveedor de análisis es la herramienta local que REA usa para ese tipo de software.
Ejecutables y bibliotecas nativas · Hopper, Ghidra o IDA
Instala una herramienta de análisis en el ordenador donde se ejecuta REA. El host es tu sistema operativo; el objetivo es el programa que quieres inspeccionar.
| Proveedor de análisis | Windows | macOS | Linux |
|---|---|---|---|
| Hopper | No disponible | 12+ | Distribuciones compatibles |
| Ghidra | x64 · experimental | x64 / arm64 | x64 / arm64 |
| IDA | Perfiles verificados | Perfil sin interfaz gráfica verificado | Consulta la guía del proveedor |
Hopper · deja que la configuración lo instale o lo conecte
Conecte Hopper en macOS o Linux . Ejecute el comando de instalación anterior; detecta una instalación existente u ofrece un plan de instalación para su aprobación.
Elige Hopper durante la configuración y revisa su plan de instalación por separado. En macOS, elige el modo de demostración o activa tu licencia cuando Hopper se abra por primera vez. En Linux, la configuración prepara la demostración compatible y su pantalla privada.
Hosts Linux: Ubuntu 24.04+, Fedora 41+, Nobara 44+, Arch Linux, CachyOS u Omarchy. Hopper es software comercial; su demostración tiene límites definidos por el fabricante.
npx -y rea-agents@latest doctor --provider hopper --json
Si macOS pide permiso de Automatización, autoriza la aplicación que inicia REA en Ajustes del Sistema → Privacidad y seguridad → Automatización y vuelve a intentarlo.
Ghidra · instala la herramienta de análisis gratuita y Java
- Instala un JDK de 64 bits, versión 21 o posterior, que incluya el compilador de Java. Elige el paquete correspondiente a la arquitectura de tu ordenador.
-
Descarga Ghidra 12.1.4 desde la lista Assets de la versión publicada y extrae el archivo
ghidra_…_PUBLIC_….zip. Elige el archivo de la versión, no «Source code». -
Busca la carpeta extraída que contiene
ghidraRunoghidraRun.bat. Usa esa carpeta paraGHIDRA_INSTALL_DIR.
Descargar un JDK · Descargar Ghidra 12.1.4
Comprueba Java. El primer comando muestra java.home; usa esa carpeta para JAVA_HOME. El segundo confirma que el compilador está instalado:
java -XshowSettings:properties -version
javac -version
Conecte Ghidra en Windows
Windows x64 tiene soporte experimental de solo lectura para aplicaciones y DLL nativas x86 y x64 PE en unidades NTFS locales fijas. Usa una instalación existente de Ghidra 12.1.x y un JDK de 64 bits, versión 21 o posterior:
$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
Reemplace las dos rutas con sus instalaciones, luego revise el plan de configuración.
Conecte su instalación de Ghidra
export GHIDRA_INSTALL_DIR="/absolute/path/to/ghidra_12.1.4_PUBLIC"
export JAVA_HOME="/absolute/path/to/jdk-21"
Sustituye ambas rutas por las de tus instalaciones existentes. En una instalación nueva de macOS o Linux arm64, compila el descompilador nativo para tu ordenador antes de continuar.
Compila el descompilador nativo de Ghidra
En macOS, la compilación necesita Xcode Command Line Tools, make y bison. Usa la guía correspondiente a tu ordenador:
Después, comprueba Ghidra y guarda sus rutas para tu cliente:
npx -y rea-agents@latest doctor --provider ghidra --json
npx rea-agents@latest setup
Ejecuta estos comandos en la misma sesión de terminal. Tras establecer las rutas, vuelve a ejecutar la configuración, aprueba la configuración actualizada del cliente y reinicia tu agente.
Configuración de Ghidra y requisitos de arquitectura · Guía de Ghidra en Windows
IDA · conecta una instalación existente
Usa la guía del proveedor IDA para preparar el registro MCP del servidor al que REA se conecta. Elige una interfaz gráfica conectada con el binario original abierto o un supervisor sin interfaz gráfica que abra una base de datos privada.
Los perfiles verificados incluyen la interfaz gráfica heredada y el supervisor sin interfaz gráfica de Windows, además de un supervisor sin interfaz gráfica en macOS arm64 con IDA Professional 9.1. El puente nativo opcional de la interfaz gráfica tiene sus propios requisitos de versión y plataforma.
El perfil sin interfaz de macOS y el puente GUI nativo requieren una compilación de REA desde el código fuente o una versión que incluya estos cambios. npm 6.4.0 no los incluye.
Desde el directorio del código fuente ya compilado, ejecuta node scripts/rea.mjs doctor --provider ida --json y node scripts/rea.mjs setup en lugar de los comandos npx de abajo.
Prepara el archivo de registro de IDA
Instala y configura el servidor al que REA se conecta siguiendo la guía de IDA de abajo. Después, guarda su registro funcional como ida-mcp.json en un editor de texto. En Windows, elige «Todos los archivos» al guardar con el Bloc de notas para que no añada .txt.
Para un supervisor sin interfaz gráfica que ofrezca idb_open, idb_list y idb_close, el archivo puede ser así:
{
"command": "idalib-mcp",
"args": ["--stdio", "--max-workers", "1"],
"mode": "headless"
}
Para un servidor de interfaz gráfica heredado 1.4.0 conectado, copia en el archivo sus valores funcionales de command, args y, si lo usa, env. Abre el binario original en IDA e inicia el complemento de ese servidor antes de pedir a REA que lo inspeccione.
$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
export REA_IDA_MCP_CONFIG="/absolute/path/to/ida-mcp.json"
export REA_ANALYSIS_PROVIDER="ida"
npx -y rea-agents@latest doctor --provider ida --json
npx rea-agents@latest setup
Usa el archivo JSON de registro que preparaste siguiendo la guía del proveedor. Después, vuelve a ejecutar la configuración y reinicia tu agente.
Perfiles de IDA, ejemplos de registro y plataformas verificadas
Una vez conectado, dale a tu agente la ruta completa del ejecutable original e indica el proveedor de análisis:
Usa REA con el proveedor que he configurado para inspeccionar
/absolute/path/to/program. Enumera sus funciones y cadenas, y después explica la parte que procesa la entrada del usuario con referencias al código.
Sitios web, Android, .NET, firmware y otros objetivos
Abre la guía del tipo de objetivo que tienes. Cada guía indica las herramientas adicionales, los hosts compatibles y el primer comando.
| Objetivo | Herramientas necesarias | Guía |
|---|---|---|
| JavaScript / Electron | Node.js + npm | Abrir guía |
| Sitio web | Chrome / Chromium / Edge | Abrir guía |
| .NET / Flutter / paquetes | Node.js + npm | Abrir guía |
| APK de Android | JADX + JDK 17+ | Abrir guía |
| Dispositivo Android | adb | Abrir guía |
| Recursos de Android | Apktool + Java | Abrir guía |
| Proyecto JEB | JEB + MCP | Abrir guía |
| Firmware | Binwalk / Unblob · Linux | Abrir guía |
| WASM | WABT | Abrir guía |
| Base de datos SQLite | Node.js 24.15+ / 26+ | Abrir guía |
| Bytecode de EVM | Node.js · Linux x64 | Abrir guía |
| ELF / fallo de Linux | pwntools / GDB / pwndbg | Abrir guía |
| HAR / SAZ / mitmproxy | Node.js / mitmdump | Abrir guía |
| PCAP / PCAPNG | TShark / capinfos · Linux | Abrir guía |
| Señales lógicas | sigrok-cli · Linux | Abrir guía |
| Comportamiento de procesos | PTY · Linux / macOS | Abrir guía |
Guía de Flutter · Paquetes y recursos · Bytecode de EVM · Todas las guías de investigación
Usa REA desde una terminal
Comandos CLI, instalación global y curl
Analice una carpeta de aplicación JavaScript o Electron o un archivo ASAR sin ejecutar la aplicación:
npx -y rea-agents@latest analyze-javascript-application "/absolute/path/to/app" --json
Reemplace la ruta con el directorio de la aplicación extraída o .asar archivo. En Windows, una ruta como "D:/apps/example" trabaja aquí.
¿Dónde encuentro el archivo .asar de una aplicación?
Las aplicaciones Electron generalmente lo mantienen en un resources carpeta:
-
Windows :
C:\Users\<you>\AppData\Local\Programs\<App>\resources\app.asar -
macOS :
/Applications/<App>.app/Contents/Resources/app.asar(haga clic con el botón derecho en la aplicación y elija Mostrar Contenido del Paquete) -
Linux : a menudo
/opt/<App>/resources/app.asar
Algunas aplicaciones se instalan en otro lugar. Busque en la carpeta de la aplicación app.asar.
El resultado identifica la aplicación, muestra las conexiones entre los módulos y proporciona sus ubicaciones de origen. Las conexiones REA que no se pueden resolver están marcadas en el resultado.
Si desea un permanente rea comando en tu shell:
npm install --global rea-agents
Continúe con la guía de aplicación del JavaScript
npx -y rea-agents@latest function "/absolute/path/to/program" main --provider ghidra --json
Sustituye main por un nombre o una dirección de función de la lista de funciones del objetivo. Ghidra debe estar configurado previamente.
En macOS o Linux también puedes usar el instalador curl después de preparar Node.js:
curl -fsSL https://raw.githubusercontent.com/morluto/rea/main/install.sh | bash
Sigue las indicaciones de configuración para conectar tu agente. Si no aparecen, ejecuta rea setup.
Si el shell no encuentra rea, usa la ruta del ejecutable que muestra el instalador. En Linux, el comando de configuración predeterminado es "$HOME/.local/bin/rea" setup.
Cómo obtener ayuda
Si su agente no ve REA
Reinicie o vuelva a conectar el cliente después de la configuración. Compruebe su conexión REA con doctor; para Codex :
Usa la comprobación del cliente del paso 3 con tu identificador de configuración. En los clientes que son editores, activa REA en los ajustes MCP y autoriza sus herramientas en el chat del agente.
Si un proveedor necesita atención
Verifique el proveedor que está usando. Para Ghidra :
npx -y rea-agents@latest doctor --provider ghidra --json
El informe proporciona la verificación fallida y un siguiente paso sugerido.
Windows, WSL y rutas con espacios
Usa Windows PowerShell para los clientes y las herramientas de análisis de Windows. Si tu agente se ejecuta dentro de WSL, instala Node.js y REA en ese entorno Linux y usa allí rutas de Linux. Los proveedores sin interfaz gráfica se ejecutan en el mismo host que REA.
En una terminal, coloque comillas alrededor de una ruta que contenga espacios.
Comando de configuración para Windows:
npx.cmd rea-agents@latest setup
Actualiza o elimina REA
Para actualizar la conexión de tu agente, vuelve a ejecutar el comando de configuración más reciente, revisa el plan y reinicia tu cliente.
npx rea-agents@latest setup
Si instalaste la CLI global, actualízala con rea update. Usa npx rea-agents@latest uninstall para eliminar la configuración de clientes y la skill de REA.
- Preguntas FRECUENTES SOBRE REARespuestas rápidas sobre actualizaciones, agentes y análisis.
- Elija una guía de investigaciónEjemplos trabajados para un binario, una aplicación Electron y un navegador.
- Problemas de GitHubInforme de un problema con el comando y los diagnósticos.
- Comunidad REAPreguntas, investigaciones y trabajo en progreso.
