Saltar a contenido

Solución de problemas

Situaciones comunes y cómo salir de ellas. Chronos es ante todo una app de escritorio: casi todos los remedios están en la propia interfaz.

El agente no parece hacer nada

La causa más común: el agente de código no tiene sesión iniciada con su proveedor. Inicia sesión en el agente que usa tu organización (tu administrador puede ayudarte) y reintenta.

La sesión del agente ha caducado

Cada agente mantiene su propio acceso con su proveedor, separado de Chronos. Cuando caduca a mitad de trabajo, la app muestra un aviso de re-autenticación para ese agente: síguelo, vuelve a iniciar sesión y reintenta el turno.

Un agente no está instalado

El selector de modelo marca los agentes cuya CLI falta y ofrece un botón Install: Chronos ejecuta el comando de instalación del adaptador y muestra el log en vivo. Cuando termina, vuelve a elegir el agente.

El agente hizo un plan pero no cambió nada

Estás en modo plan y es lo esperado: el modo plan propone un enfoque sin tocar nada. Envía una instrucción normal (o apaga Plan en el chat) para que lo ejecute.

Un comando pide aprobación

El comando es sensible (borrar muchos datos, instalar software). Alguien con el permiso adecuado tiene que aprobarlo antes de que corra; te aparecerá en la cola de atención. Es intencionado: Chronos no ejecuta acciones de alto impacto en silencio. Desde la CLI, reintenta con --approve cuando tengas el permiso.

No puedo mergear

Un merge necesita todo esto: checks en verde, las aprobaciones requeridas y permiso de merge. La app te enseña exactamente qué falta. Pasa los checks, consigue la aprobación y confirma tu permiso. Ver Pull requests y merge.

Falta una herramienta o capability que necesito

Las herramientas, agentes y capabilities disponibles se gestionan de forma central en tu organización. Si algo no está, pídeselo a tu administrador de Chronos: no se puede añadir en local, por diseño.

Mi sesión ha desaparecido

No debería: las sesiones se guardan y sobreviven a los reinicios. Comprueba que tienes abierto el mismo repositorio (el workspace al que pertenece la sesión). Si sigue sin aparecer, contacta con tu administrador.

Chronos no puede leer mi repo en Documentos, Escritorio o Descargas (macOS)

macOS protege esas carpetas con un permiso por app, así que Chronos muestra un error de acceso específico en vez de un engañoso "no es un repositorio git". Concede el acceso en Ajustes del Sistema › Privacidad y seguridad, o mueve el repositorio fuera de la carpeta protegida (por ejemplo a ~/Chronos o ~/code).

El puerto del dashboard está ocupado

Otro chronosd (o cualquier otra app) ya escucha en 4173. El motor lo registra como Address already in use y sigue funcionando sin dashboard web: la app y la CLI siguen operativas. Para el otro proceso, o mueve el dashboard con la variable de entorno CHRONOS_HTTP_PORT.

La CLI dice que no llega a chronosd

La app de escritorio gestiona su propio motor y no necesita nada. El comando chronos suelto, en cambio, es un cliente ligero del daemon: si dice que no puede alcanzar chronosd, arráncalo con chronosd y reintenta.

Otra cosa

Si tu problema no está aquí, contacta con tu administrador de Chronos o tu contacto de soporte. Ven el registro central de actividad y pueden diagnosticar qué pasó.