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.

El proveedor CLI no es lanzable

Si el lanzador dice que no hay proveedores CLI/ACP 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.

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