Repolode
reticlehq

reticlehq/reticle

SDK y servidor MCP solo para desarrollo que permiten a los agentes de programación con IA controlar una app web o de escritorio en ejecución y emitir un veredicto de aprobado, fallido o indeterminado con pruebas.

Estrellas
1,276
Forks
220
Issues abiertos
220
Último commit
hace 17 horas

¿Qué es?

Reticle resuelve una carencia habitual en la programación asistida por IA: un agente escribe un cambio, da por hecho que funciona y nunca abre la app. Reticle instala un pequeño SDK, solo para desarrollo, dentro de la app y expone herramientas mediante MCP para que el agente pueda inspeccionar, controlar y observar la aplicación en ejecución, además de comprobar su comportamiento.

Como el SDK lee los datos desde dentro de la página, puede ver las respuestas de red asociadas al clic que las provocó, el estado de bibliotecas como zustand, Redux, TanStack Query y Pinia, los errores de la consola y el archivo y la línea de origen de cada elemento. Cada comprobación termina con un veredicto de sí, no o desconocido, acompañado de las pruebas. Los flujos guardados se pueden volver a ejecutar más adelante sin un modelo de IA, y `reticle gate` se puede usar en CI para exigir una ejecución aprobada cuando cambia código cubierto.

Reticle es compatible con React, Next.js, Vue, Svelte, Angular y stacks web similares, además de apps de escritorio con Electron y Tauri, y funciona con Claude Code, Cursor, Codex, Windsurf, VS Code, Gemini CLI y otros clientes MCP. El puente solo escucha en localhost y las compilaciones de producción excluyen el SDK.

Funciones clave

  • 01Proporciona a los agentes de programación herramientas para inspeccionar, controlar y observar una app en ejecución, además de comprobar su comportamiento.
  • 02Devuelve veredictos de sí, no o desconocido, con la solicitud, el cambio de estado y el archivo:línea como pruebas.
  • 03Lee respuestas de red, estado de los stores, salida de la consola y renders de React desde dentro de la página.
  • 04Vuelve a ejecutar los flujos guardados de forma determinista, sin invocar un modelo de IA.
  • 05Ofrece `reticle gate` para exigir ejecuciones aprobadas en CI cuando cambia código cubierto.
  • 06Excluye el SDK de las compilaciones de producción y limita el puente local a 127.0.0.1.

Casos de uso

  • Comprobar que un cambio en el checkout o el inicio de sesión realizado por un agente funciona realmente en la app en ejecución.
  • Detectar fallos silenciosos, como una respuesta 500 detrás de un mensaje de éxito.
  • Fijar recorridos críticos de usuario para evitar que cambios posteriores los rompan sin que nadie lo note.
  • Exigir la verificación de los flujos cubiertos en CI antes de integrar los cambios.

Inicio rápido

  1. 1

    Instala el comando reticle globalmente con npm

    npm install -g @reticlehq/server
  2. 2

    Registra Reticle en tus agentes de programación

    reticle setup mcp
  3. 3

    Reinicia tu agente de programación y ejecuta init en la carpeta de tu aplicación

    reticle init

Antes de usarlo

  • El servidor y la CLI tienen el código fuente disponible bajo FSL-1.1-ALv2, pero no son software de código abierto aprobado por la OSI. Pasarán a Apache-2.0 después de dos años.
  • Necesita Node 20.11 o posterior, un servidor de desarrollo ejecutándose localmente y un agente de programación compatible con MCP.
  • Controla un navegador Chromium y, de forma predeterminada, recopila telemetría de uso anónima, salvo que la desactives.

Temas

Preguntas frecuentes

¿Qué es reticle?
SDK y servidor MCP solo para desarrollo que permiten a los agentes de programación con IA controlar una app web o de escritorio en ejecución y emitir un veredicto de aprobado, fallido o indeterminado con pruebas. Reticle resuelve una carencia habitual en la programación asistida por IA: un agente escribe un cambio, da por hecho que funciona y nunca abre la app. Reticle instala un pequeño SDK, solo para desarrollo, dentro de la app y expone herramientas mediante MCP para que el agente pueda inspeccionar, controlar y observar la aplicación en ejecución, además de comprobar su comportamiento.
¿reticle es gratuito? ¿Qué licencia tiene?
reticle es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿reticle sigue mantenido?
Mantenimiento activo. El último commit de reticle fue el 21 oct 2026.
¿Para qué puedo usar reticle?
Comprobar que un cambio en el checkout o el inicio de sesión realizado por un agente funciona realmente en la app en ejecución. Detectar fallos silenciosos, como una respuesta 500 detrás de un mensaje de éxito. Fijar recorridos críticos de usuario para evitar que cambios posteriores los rompan sin que nadie lo note. Exigir la verificación de los flujos cubiertos en CI antes de integrar los cambios.
¿Cómo se instala reticle?
Instala el comando reticle globalmente con npm: npm install -g @reticlehq/server Registra Reticle en tus agentes de programación: reticle setup mcp Reinicia tu agente de programación y ejecuta init en la carpeta de tu aplicación: reticle init
¿Dónde consigo reticle?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/reticlehq/reticle

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados