Copiloto en la aplicación
Estás en la aplicación, mirando el error. El agente está en otra ventana, ciego — y el trabajo se convierte en describir en prosa lo que tienes justo delante. El puente de Spaccy corre dentro de tu aplicación en desarrollo: el copiloto empieza a ver la pantalla, el error y el elemento que señalaste, sin que tengas que salir de ahí.
Solo en desarrollo, por construcción — ningún símbolo del puente sobrevive al build de producción, y eso lo verifica una prueba sobre el artefacto generado.
Lo que el agente empieza a ver
La mitad de una conversación con un agente es reconstruir en texto lo que ya está en la pantalla. Esa mitad desaparece.
El puente publica la aplicación, la URL, la ruta y el framework en cada navegación — sin rehacer la conversación. Dejas de escribir "estoy en la pantalla de registro, en la pestaña de dirección, con el formulario ya completado": el agente ya lo sabe.
Los errores de consola y las peticiones que volvieron con 400 o 500 en la ventana actual llegan junto con tu pregunta, con el stack intacto. El ciclo de copiar el error de las DevTools, pegarlo en el chat y esperar no haber cortado la línea que importaba simplemente desaparece.
Recargar la aplicación — o que el hot reload salte solo — reconecta la misma sesión por su id, con los mensajes y las aprobaciones pendientes intactas. Ninguna sesión huérfana, ningún contexto reconstruido desde cero solo porque guardaste un archivo.
Del píxel al archivo
La pregunta que más tiempo consume en una base de código grande no es cómo arreglarlo — es dónde se genera esto. El puente responde desde el lado de la pantalla.
Una capa de selección te deja hacer clic en el elemento — y las flechas ↑ ↓ suben y bajan por la jerarquía cuando lo que quieres es el contenedor, no el botón. Hasta diez elementos pueden ir juntos en el mismo turno, identificados uno a uno.
Cuando el proyecto tiene el plugin de build, el origen llega con archivo, línea y columna. Sin él, la búsqueda baja a otras dos capas de pistas y devuelve candidatos clasificados — cada uno con su propio nivel de confianza y la evidencia que lo respalda.
El panel dice literalmente que son hipótesis clasificadas y que el agente confirma leyendo el archivo. Ningún candidato se presenta como verdad — lo que evita el peor fallo de este tipo de herramienta: señalar el archivo equivocado con convicción y mandar al agente a reescribirlo.
De la pantalla al resto del harness
A partir del elemento señalado, el puente recorre el camino inverso — del archivo de vuelta a los artefactos que lo citan — y trae la propuesta, la especificación o la decisión de arquitectura que produjo esa pantalla. Y si ningún artefacto cita el archivo, dice que no encontró nada, en vez de inventar algo plausible.
¿Encontraste un error mientras navegabas? El reporte sale desde ahí mismo, ya con ruta, elemento, error de consola y captura adjuntos — y entra en el registro de pendientes como ítem rastreado, con severidad y dueño. El error deja de depender de que alguien recuerde abrir el ticket después.
Antes de enviar, el panel muestra exactamente lo que va a llegar al agente, con contraseña, token y cabecera de autorización ya sustituidos por [redacted]. Si algo ahí no debería salir, quitas el elemento antes de enviar. La revisión es tuya, y ocurre antes — no después.
Cuando el agente actúa
Un agente que hace clic y escribe en tu aplicación es útil, y es peligroso — en ese orden. Por eso el actuar nació cerrado: cada llave siguiente es código, no una recomendación.
El agente puede hacer clic en un elemento, rellenar un campo y navegar a una ruta. Nada más. El vocabulario está cerrado en el protocolo y verificado por pruebas en los dos lados — un comando fuera de la lista se rechaza por diseño, no por un caso olvidado.
click · fill · navigate-route
Toda acción abre una petición en el panel con la acción, el objetivo, el valor y la ruta, y expira sola si no decides. El botón de "permitir siempre" no existe a propósito: el aviso en pantalla es que la acción no se deshace con git, y por eso mismo no puede autorizarse en lote.
Permitir 1 vez · Rechazar
Si el origen de la aplicación no es loopback, el comando se rechaza — y ese rechazo no tiene override, ni por configuración, ni por permiso de administrador. El agente no actúa en una aplicación publicada porque no existe ningún camino de código que lo permita.
Interrumpir el canal es acción tuya, del lado de la aplicación. Cortado el canal, todo comando que llegue después se rechaza automáticamente. Y un campo que parezca contraseña, token o secreto se rechaza como objetivo antes incluso de que aparezca la petición.
Cómo entra en tu aplicación
Un comando instala, verifica y desinstala. La desinstalación devuelve el archivo al byte exacto de antes, probado por checksum — no es "debería haber vuelto a la normalidad".
En un proyecto Vite, el puente entra como plugin — y es ese vector el que habilita el anclaje más preciso, con archivo, línea y columna. La instalación se verifica de verdad: el motor carga la configuración resultante y prueba que el plugin está ahí.
Cuando no se puede tocar el proyecto — otro framework, repositorio de terceros, política de no alterar archivos — el puente entra por un proxy delante del dev server, inyectando el cargador en las respuestas HTML y pasando el hot reload intacto. Cero archivos tocados en tu repositorio.
Ejecutarlo dos veces no duplica nada, y el motor se niega a instalar cuando no puede probar mecánicamente el resultado — en ese caso indica el proxy, en vez de dejar una instalación a medias que solo aparece cuando la vayas a usar.
# dentro de tu agente de IA:
> /bridge install --app web --vector vite
> /bridge status --app webSolicita acceso anticipado y lleva el copiloto dentro de la aplicación que ya estás construyendo.