Deja que un agente lo configure

Puedes delegar la parte aburrida

Este repositorio fue escrito para que un agente de codificación pueda leerlo. Incluye un archivo de mapa (llms.txt), un archivo de reglas (AGENTS.md), notas de memoria por archivo (.ai/) y skills de tareas (.agents/skills/). El checkout independiente de Desktop no incluye la carpeta prompts/, por lo que el prompt preparado está impreso en esta guía: cópielo desde abajo en lugar de abrir un archivo.

Delegar la escritura no significa saltarse las comprobaciones. El agente trabaja dentro de tu copia del repositorio y debe informar lo que hizo con evidencia. Las secciones siguientes muestran cómo luce un buen informe, para que sigas controlando el resultado.

Esta ruta configura el shell de Tauri y su conexión con el backend Web —el servidor que gestiona cuentas y datos—. La ventana de escritorio solo muestra ese backend; si su checkout también contiene apps/web, el agente puede ejecutarlo localmente, y un checkout solo de Desktop necesita la dirección de backend accesible que se le proporcionó.

• Ejecute la aplicación Desktop a mano en su lugar

Lo que necesitas primero

Termina primero la guía de preparación: Node.js, Git y un editor instalados, la invitación de GitHub aceptada y la carpeta supastack descargada en tu computadora. El agente trabaja dentro de esa carpeta, así que todo lo de Antes de empezar sigue vigente.

También necesitas una herramienta que pueda actuar como agente de código — un editor con un agente de código de IA integrado (un IDE con IA), o un agente que se ejecuta en tu terminal (una CLI de agente). Vale cualquier herramienta actual con capacidad de agente; el prompt ya especifica lo que debe leer y ejecutar, así que no tienes que escribir las instrucciones tú mismo.

Por último, decida dos cosas que pide el prompt: la dirección de backend que debe cargar la ventana —http://localhost:3000 para un backend local o su dirección HTTPS proporcionada— y si Rust y las herramientas de compilación nativas ya están instaladas en esta computadora.

Copia el prompt, rellena dos espacios y pégalo

El prompt es el bloque de código a continuación: seleccione y copie todo el bloque.

Dos marcadores de posición necesitan su elección. Reemplace <APP_URL> con la dirección de backend que debe cargar la ventana —http://localhost:3000 para un backend local o su dirección HTTPS proporcionada. Reemplace <TOOLCHAIN: present | install> con present cuando rustc y cargo ya impriman versiones, o install cuando el agente deba instalar primero Rust y las herramientas de compilación del SO. Los pasos numerados permanecen exactamente como están escritos.

Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

Qué hace el agente con el prompt

El prompt señala al agente el mapa, las reglas y la lista de verificación de seguridad, luego le indica que trabaje en la configuración en orden y pruebe cada fase. En términos simples, el agente:

• Lee el mapa del repositorio (llms.txt), las reglas del proyecto (AGENTS.md) y las reglas de manejo de credenciales (docs/agent-security.md) antes de tocar nada.
• Comprueba la toolchain de Rust y los prerrequisitos de Tauri de este SO, e informa lo que instala en lugar de fallar a mitad de una compilación.
• Verifica que el backend responde en su dirección —iniciando apps/web él mismo solo cuando esa carpeta existe en este checkout—, en lugar de asumir un servidor que no está ahí.
• Instala dependencias, compila el shell y abre la ventana, luego informa el comportamiento de la ventana, la bandeja y el atajo de invocación con la salida real.
• Se detiene e informa después de que el mismo paso falla dos veces: no sortea un fallo ni elimina nada sin preguntar.

Qué revisar en el informe del agente

Un buen informe muestra evidencias, no afirmaciones. Busque la URL del backend respondiendo, la instalación de dependencias completada, una compilación de Rust terminada y una ventana abierta detrás de cada PASS, no una frase como 'todo funciona'.

El prompt le indica al agente que se detenga e informe después de que el mismo paso falle dos veces —no que sortee el fallo— y que le pregunte antes de cualquier acción destructiva. Si su agente sigue improvisando después de fallos repetidos, deténgalo y lleve el primer error a la guía de solución de problemas.

Dos cosas no deben aparecer nunca: una función de seguridad desactivada para silenciar un error, y un valor secreto como una contraseña o clave impreso en el chat o en el informe. Si ves alguna de las dos, considera la ejecución como fallida.

Mantenga separados en su mente el shell y el inicio de sesión real. La ventana que muestra la página de inicio de su backend prueba el shell: las cuentas reales aún necesitan la base de datos del backend. 'La ventana se abrió' aún no es 'las cuentas funcionan'.

Si prefieres hacerlo a mano

Cada paso que realiza el agente está escrito en las guías manuales a continuación: los mismos comandos, las mismas verificaciones, a su ritmo.

• Ejecute la aplicación Desktop en 5 minutos
• Lea la configuración completa del shell
• Solucione un fallo de configuración