Cómo utilizar REA con agentes de programación: tu primera investigación

Para utilizar REA con un agente de programación, ejecuta npx rea-agents@latest setup, aprueba los cambios de configuración para el cliente elegido y reinícialo. Después, indica al agente un objetivo de software local y un comportamiento concreto que investigar; pide el código pertinente, las ubicaciones en el código fuente y las limitaciones antes de solicitar que construya nada.

REA es una CLI y un servidor MCP de código abierto. Este artículo es una guía comunitaria independiente; rea.tools y el repositorio morluto/rea son las fuentes del proyecto oficial.

¿Qué necesitas antes de instalar REA?

REA requiere Node.js 22.x a partir de 22.19, Node.js 24.x a partir de 24.11, o Node.js 26 y posteriores, además de npm. Node.js 23, 25 y las versiones preliminares quedan fuera del intervalo de compatibilidad documentado. Consulta la guía oficial de instalación cuando prepares una máquina nueva.

Elige un objetivo que te pertenezca o que tengas permiso para examinar. Una aplicación JavaScript extraída o un archivo ASAR de Electron es un primer objetivo útil, porque el análisis estático de aplicaciones de REA no requiere Hopper, Ghidra ni IDA. El análisis profundo de binarios nativos utiliza uno de esos motores y tiene requisitos adicionales de plataforma y versión. El README de REA enumera las familias de objetivos compatibles y sus requisitos previos.

¿Qué quieres hacer?	Punto de partida recomendado	Entrada	Resultado
Pedir a un agente que explique una función	Configuración MCP de REA	Ruta del objetivo local y una pregunta concreta	Hallazgos, pruebas e investigación posterior
Inspeccionar una aplicación sin un agente	CLI de REA	Directorio de una aplicación JavaScript extraída o archivo ASAR	Pruebas estructuradas sobre la aplicación
Inspeccionar manualmente la disposición de una página web o pausar JavaScript	Chrome DevTools	Página abierta en Chrome	Edición directa de DOM/CSS y control de puntos de interrupción
Explorar por tu cuenta las funciones y los grafos de un binario	Ghidra	Ejecutable o biblioteca compatibles	Desensamblado y descompilación interactivos, y proyecto de análisis

Chrome DevTools y Ghidra ofrecen potentes interfaces de inspección directa. REA resulta útil cuando quieres que tu agente te ayude a orientar una investigación y a convertir determinados hallazgos en una explicación o implementación. Consulta nuestra comparativa con Ghidra y nuestra comparativa con Chrome DevTools.

¿Cómo conectas REA a un agente de programación?

Ejecuta el comando oficial de configuración en una terminal:

npx rea-agents@latest setup

Selecciona el cliente deseado, revisa la configuración exacta y las rutas de las habilidades y aprueba el plan. La configuración registra el servidor MCP local de REA e instala las instrucciones de investigación correspondientes. Reinicia el cliente indicado en el mensaje de finalización para que el agente en ejecución pueda descubrir la conexión. La documentación oficial de configuración explica la vista previa, las copias de seguridad y los controles de alcance.

Para comprobar el registro de Codex, utiliza:

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

Sustituye codex por el identificador de tu cliente compatible cuando corresponda. Un resultado correcto de doctor comprueba los archivos de registro y los requisitos previos; no demuestra que la sesión actual del agente se haya vuelto a conectar. Si el agente sigue sin detectar REA, reinícialo o vuelve a conectarlo e inspecciona el error de su conexión MCP. Instalar únicamente la habilidad de skills.sh proporciona instrucciones, no la conexión MCP. La guía oficial de solución de problemas explica estas diferencias.

¿Qué deberías pedir a REA que encuentre en tu primera instrucción?

Elige un comportamiento observable en lugar de pedir la reconstrucción de una aplicación completa. Para una aplicación que tengas autorización para inspeccionar, una instrucción concreta sería:

Utiliza REA para inspeccionar /absolute/path/to/my-notes-app.
Explica cómo la aplicación exporta notas como CSV.
Muestra los módulos pertinentes, las ubicaciones en el código fuente y las pruebas.
Distingue el comportamiento confirmado de todo lo que no puedas determinar.

Sustituye la ruta por tu objetivo real. REA proporciona resultados de investigación; el agente de programación los interpreta. Antes de aceptar la respuesta, comprueba si el resultado identifica los archivos del objetivo, el código pertinente y cualquier cobertura incompleta. Una explicación plausible sin una ubicación que la respalde es una hipótesis que requiere más investigación.

Si MCP no está disponible, la inspección estática de JavaScript también puede ejecutarse directamente:

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

El comando acepta un directorio de aplicación extraído o un archivo ASAR y devuelve un registro Evidence. Los fallos de proveedores nativos en una auditoría no impiden automáticamente este flujo de JavaScript separado. La guía de REA para comprobar la preparación según el alcance recomienda comprobar la tarea que realmente necesitas.

¿Cómo compruebas un resultado antes de reconstruir una función?

Convierte la explicación en una pequeña predicción. Para un exportador CSV, compara una nota normal con otra que contenga una coma, comillas o un salto de línea. Pregunta al agente qué rama gestiona esos caracteres y cómo coincide la salida prevista con la exportación observada de la aplicación original. Distingue la salida observada del código de sustitución propuesto por el agente.

La investigación oficial de Notes utiliza una exportación CSV para enseñar este proceso. El ejemplo oficial del dinosaurio ilustra un objetivo distinto: REA lee el script cargado por el juego del navegador, el agente identifica su regla de aceleración y una pequeña reconstrucción permite ajustar la velocidad. Son ejemplos desarrollados por el proyecto, no testimonios de usuarios independientes.

¿Cuáles son las limitaciones de las versiones publicadas y de la privacidad?

La rama main del repositorio puede documentar funciones más recientes que el paquete publicado en npm. @latest solicita la versión actual de npm; los registros persistentes de MCP quedan fijados a la versión exacta que realizó la configuración. Vuelve a ejecutar la configuración y reinicia el agente al actualizar. Elige las funciones según la lista real de herramientas y los esquemas del servidor conectado, en lugar de suponer que están instaladas todas las funciones de la rama main. La documentación oficial sobre los límites de la versión publicada explica esta diferencia.

REA analiza los objetivos en tu máquina. Los resultados de las herramientas se envían a tu agente de programación, cuyo proveedor de modelos tiene su propia política de datos. Revisa el contenido de un resultado antes de compartirlo, especialmente los fragmentos de código fuente, las rutas locales, las solicitudes capturadas o los datos de la aplicación. Las preguntas frecuentes oficiales describen este límite entre el análisis local y el proveedor del modelo.

¿Qué preguntas surgen después de la primera investigación?

¿Puedo utilizar REA sin Hopper, Ghidra o IDA?

Sí. La inspección estática de JavaScript/Electron y .NET no necesita un motor de análisis nativo. El análisis nativo profundo sí. Elige los requisitos previos según el objetivo, en lugar de considerar obligatorio cada proveedor opcional.

¿Recupera REA el código fuente original?

El análisis nativo devuelve código ensamblador y pseudocódigo con hallazgos que los respaldan. El pseudocódigo es una representación para el análisis, no una promesa de reproducir el código fuente original. El agente puede utilizar los hallazgos para escribir una nueva implementación y probarla.

¿Puedo ejecutar REA sin una suscripción de IA?

La CLI de REA puede ejecutar directamente los flujos de análisis. Utilizar un agente de programación implica cumplir los requisitos de acceso de ese cliente y las condiciones del proveedor de modelos. La licencia MIT de REA no proporciona acceso a modelos ni una licencia de un motor de análisis comercial.

¿Qué debo hacer cuando falla un comando?

Comprueba los requisitos previos documentados y actualiza REA primero. Para una CLI instalada globalmente, rea update actualiza la instalación a la que pertenece; para una configuración de agente basada en npx, vuelve a ejecutar npx rea-agents@latest setup y reinicia el cliente. Si el fallo persiste, informa de la versión de REA, el sistema operativo, el tipo de objetivo, el proveedor, los pasos y la salida del error a través del sistema oficial de incidencias.