Ejecutar el proyecto
El diff te dice qué cambió; ejecutar la app te dice que funciona. La zona Run del panel derecho arranca tu proyecto dentro de la copia de trabajo de la sesión, con su log en directo, para que pruebes lo que el agente acaba de construir sin salir de la sesión.
El script run y CHRONOS_PORT
Qué significa "run" lo define tu equipo una sola vez, en el fichero versionado .chronos/settings.toml. Chronos asigna a cada sesión su propio puerto libre y lo pasa como CHRONOS_PORT, así que varias sesiones en paralelo nunca chocan.
- Run arranca el servidor; Restart y Stop gestionan el proceso. Parar una sesión mata su grupo de procesos entero: sin huérfanos.
- Open ↗ abre la URL de la sesión en tu navegador.
- Sin sesión seleccionada, el panel Run de la cabecera ejecuta el proyecto desde el checkout principal del workspace, para cuando solo quieres la app levantada.
Usa el puerto de la sesión
Tu script run debe leer CHRONOS_PORT (o un alias declarado en port_env), nunca un puerto fijo. Es lo que permite tener varias sesiones levantadas a la vez.
Monorepos: targets
Un repo con varios paquetes ejecutables declara un target por unidad en .chronos/settings.toml en lugar de un único run. La barra de targets del panel Run cambia entre ellos: cada target corre en su propio directorio con su propio puerto, así que web y api pueden estar levantados a la vez. El target marcado como primary es al que apuntan el navegador integrado y los workflows.
Un repo sin targets se comporta como siempre: su run único hace de target implícito.
Configure automatically
Si el workspace no tiene nada ejecutable configurado, el panel Run ofrece Configure automatically: el agente analiza el repo en modo solo lectura y propone la sección de scripts, monorepos incluidos. La propuesta queda pendiente hasta que alguien con permiso para aprobar settings la acepta; al aceptar, el fichero se escribe en la copia de trabajo y el cambio viaja en el PR, revisable como cualquier otro código. Siempre puedes escribir el fichero a mano.
Variables de entorno
El chip Variables del panel Run gestiona el .env de tu proyecto: guardado por workspace en el llavero del sistema e inyectado en scripts, servidores, terminal y agente. Además se materializa como fichero real en cada copia de trabajo. Ver Variables del proyecto.
Overrides personales
Tu máquina puede necesitar un run distinto del de equipo (otro gestor de paquetes, un flag extra). Ponlo en .chronos/settings.local.toml en la raíz del workspace: es personal, no se versiona y solo cubre los slots ergonómicos (setup, run, run_mode, también por target). Los hooks de verificación salen solo del fichero versionado, así que un fichero local nunca debilita la puerta de merge. Tu organización puede desactivar esta capa entera con un pack (ver Capacidades).
Modo de red externa
Las sesiones corren bajo la política de salida del sandbox. Para la rara tarea que de verdad necesita internet abierto (una integración contra una API viva, un scraping), el panel Run ofrece un conmutador de red externa por sesión: abre la salida de esa sesión y muestra una franja de aviso visible mientras está activo.
El conmutador solo existe si tu organización tiene habilitado el pack correspondiente: viene desactivado por defecto, porque activarlo relaja una garantía. Cada cambio queda auditado.