Solución de problemas

Usa esta página cuando el panel parezca desincronizado con tu máquina, una sesión desaparezca o un runtime CLI alojado necesite recuperación.

No aparece nada en el panel

Si el panel dice que no hay máquinas o sesiones, revisa primero el daemon local:

adhdev daemon:status

Busca:

• un proceso de daemon en ejecución
• IPC local accesible
• estado de session-host si usas agentes CLI

Si el daemon no está en ejecución, vuelve a iniciarlo o reinstala el servicio en segundo plano si normalmente ejecutas ADHDev de esa forma.

Falta un IDE o agente

Antes de relanzar nada, revisa las superficies del panel que ahora ocultan el trabajo menos urgente:

• Pestañas ocultas
• Bandeja de actividad
• Historial

Si la máquina está conectada pero falta una sesión de IDE específica, relanza ese IDE a través de ADHDev para que se inicie con la superficie de control esperada:

adhdev launch cursor

Usa el target correspondiente a tu IDE.

El chat se ve vacío o atascado cargando

Si la sesión existe pero el chat está en blanco o todavía cargando:

1. Espera unos segundos a que el stream de la sesión se estabilice.
2. Reabre la sesión desde la franja de pestañas, la bandeja o el historial.
3. Verifica si la herramienta IDE o CLI original sigue en ejecución.
4. Si es un runtime CLI, inspecciona el session host en lugar de lanzar una sesión duplicada inmediatamente.

Para configuraciones intensivas en CLI, un chat faltante a menudo significa que el runtime sobrevivió pero el panel necesita readjuntarse a él.

Una sesión parece atascada "generando" para siempre

Si una sesión CLI ha mostrado "generando" durante mucho más tiempo del que debería tomar la tarea, primero revisa el ajuste Alerta de sin progreso en ese agente (botón de engranaje del panel) — dispara una notificación en cuanto un turno supera su umbral, lo cual suele ser la primera señal real de que algo va mal en lugar de simplemente un turno largo. Si la propia terminal se ve congelada o corrupta (más frecuente con Antigravity CLI después de cierta salida de herramienta), reabre la sesión — ADHDev forzará un redibujado y volverá a comprobar el estado real. Si sigue atascada después de eso, usa la ruta de recuperación de session-host de arriba en lugar de forzar el cierre y relanzar una sesión duplicada.

El proveedor CLI no es lanzable

Si el lanzador dice que no hay proveedores CLI utilizables, o falta un proveedor integrado en el lanzamiento:

1. Abre la pestaña Providers de la máquina.
2. Habilita el proveedor en esa máquina.
3. Ejecuta Detect y lee el detalle de detección/verificación en la tarjeta del proveedor.
4. Configura una ruta/argumentos de ejecutable personalizados si el binario upstream está instalado fuera del PATH predeterminado.
5. Si cambiaste el modo de fuente de proveedor o providerDir, haz clic en Apply + Reload antes de intentar un nuevo lanzamiento.

El inventario de proveedores integrados está intencionalmente separado de la capacidad de lanzamiento de la máquina. Un proveedor se vuelve lanzable solo después de que la activación y la detección locales tengan éxito.

La sesión CLI está atascada después de un reinicio

Los runtimes CLI alojados ahora tienen una ruta de recuperación dedicada.

Primero inspecciona el estado del session-host:

adhdev daemon:session-host

Acciones de recuperación comunes:

adhdev daemon:session-host --session <sessionId> --resume
adhdev daemon:session-host --session <sessionId> --restart
adhdev daemon:session-host --prune-duplicates

Puedes hacer lo mismo desde la pestaña Hosted Runtimes de la máquina en el panel.

Úsalo cuando:

• una sesión CLI sobrevivió a un reinicio del daemon
• un runtime está atascado en un estado interrumpido
• se crearon runtimes alojados duplicados para la misma sesión
• un runtime todavía existe pero el panel está adjunto a la copia equivocada

La Vista remota no está disponible

Si la Vista remota está en blanco o muestra una advertencia de CDP:

1. Relanza el IDE a través de adhdev launch <ide>.
2. Confirma que el IDE es uno de los flujos basados en Electron que ADHDev puede controlar bien.
3. Verifica si tu red o navegador está interfiriendo con la conexión en vivo.

Si el resto de la sesión funciona pero la Vista remota no, trátalo primero como un problema de superficie de control del IDE, no como un fallo general del panel.

Una sesión CLI parece inactiva pero nunca responde

Si una sesión CLI se queda ahí respondiendo al instante sin nada, o parece inactiva sin ser realmente utilizable, comprueba si el inicio de sesión de la herramienta subyacente ha expirado — una causa común es un login/sesión/credencial expirado que la propia CLI reportó ("Login expired", "session has expired", etc.). ADHDev detecta esto por sesión y marca la sesión como con error en lugar de dejarla con apariencia de worker inactivo saludable. Vuelve a autenticar la propia herramienta (su propio comando de inicio de sesión) y luego relanza o reconecta la sesión.

Repo Mesh omite un proveedor durante el despacho

Si una tarea de Repo Mesh nunca es reclamada por un nodo que esperabas que la tomara, comprueba si el proveedor de ese nodo está reportando actualmente agotamiento de cuota/límite de uso (adhdev quota <provider>). La cola del mesh deliberadamente no despachará trabajo nuevo a un proveedor del que tiene una lectura reciente como agotado, y en su lugar enruta a otro nodo inactivo. En cuanto la cuota se restablece (o ejecutas adhdev quota refresh <provider>), el nodo vuelve a ser elegible.

Ventana de consola de Windows parpadea durante la actualización (parcialmente corregido en 1.0.60)

En Windows, una ventana de consola puede parpadear brevemente mientras se ejecuta adhdev update y justo después de que el daemon se reinicia en la nueva versión. 1.0.60 elimina los parpadeos del propio pipeline de actualización (la instalación de npm, el intercambio de instalación atómica y el sondeo de comprobación de salud), y también corrige el parpadeo que aparecía por cada proveedor CLI instalado justo después de que arranca el daemon actualizado (sondea el --version de cada CLI). Aún se conoce un parpadeo en el que se sigue trabajando: una ventana node.exe cuando se detiene una sesión, que proviene de una llamada de una librería de terceros sin opción propia para ocultar la ventana. Es cosmético — la detención de sesión igualmente se completa con normalidad. Si ves un parpadeo en cualquier otro momento, repórtalo con el título de la ventana.

Las notificaciones no llegan

Abre Notifications en el panel y verifica:

• que las notificaciones globales estén habilitadas
• que las notificaciones del navegador estén habilitadas
• que las notificaciones push estén habilitadas si usas la ruta de nube alojada
• que la configuración de alertas a nivel de proveedor no esté suprimiendo el evento que esperas

Las notificaciones push son solo de la nube y funcionan mejor cuando ADHDev se instala como PWA en móvil.

El panel móvil se siente atascado

Los navegadores móviles son más agresivos al suspender las pestañas en segundo plano.

Prueba:

1. deslizar para actualizar
2. reabrir la sesión activa desde la bandeja
3. reabrir la pestaña por completo si la conexión no se recuperó

Si solo necesitas revisar aprobaciones, la bandeja suele ser más fiable que esperar a que la vista de chat anterior se restaure a sí misma.

Sigue sin funcionar

Si el estado local se ve inconsistente, recopila el estado actual primero:

adhdev doctor
adhdev daemon:status
adhdev daemon:session-host --json

adhdev doctor ahora también verifica si los binarios adhdev / adhmux del PATH están obsoletos, rotos o les falta la superficie de runtime más nueva. Si los comandos runtime parecen inconsistentes con la documentación, revisa la salida de doctor antes de asumir que la capa session-host/runtime está mal.

Luego revisa:

• los logs del daemon en ~/.adhdev/logs/
• la pestaña Logs de la máquina en el panel
• la pestaña Hosted Runtimes de la máquina para runtimes interrumpidos

Último recurso

Si la instalación en sí está corrupta, una reinstalación limpia sigue siendo el respaldo:

adhdev uninstall -f
npm uninstall -g adhdev
npm install -g adhdev
adhdev setup
adhdev service install

WARNING

Esto elimina los datos locales de ADHDev, incluyendo el estado de autenticación, los logs y la configuración en caché.

Obtener ayuda

• Compatibilidad y advertencias
• Panel
• Agentes CLI
• Autoalojado
• GitHub Issues: github.com/vilmire/adhdev/issues