Agentes CLI

Los agentes CLI son uno de los flujos de trabajo principales de ADHDev. Hoy ADHDev incluye 7 proveedores CLI integrados en el catálogo. Se ejecutan a través de la capa PTY/session-host del daemon después de que el proveedor se habilite y se detecte en la máquina de destino, para que puedas ver la salida de terminal, escribir desde el panel y mantener las sesiones en marcha desde escritorio o móvil.

Agentes como Aider, Gemini CLI, GitHub Copilot CLI y Goose no son proveedores CLI integrados — en su lugar se conectan a través del Agent Client Protocol (stdio). Consulta la guía de agentes ACP para esos.

WARNING

Integrado no significa soporte verificado. A menos que un proveedor se promueva explícitamente en la documentación de compatibilidad, trátalo como no verificado.

Proveedores CLI integrados

Agente	Comando	Verificación	Descripción
Antigravity CLI	adhdev launch antigravity-cli	No verificado	Agente de terminal Antigravity de Google
Claude Code	adhdev launch claude	Parcial	Agente de codificación Claude de Anthropic
Codex CLI	adhdev launch codex	Parcial	Agente de terminal Codex de OpenAI
Cursor CLI	adhdev launch cursor-cli	Parcial	Flujo de trabajo de agente de terminal de Cursor
Hermes	adhdev launch hermes-cli	No verificado	Agente de codificación Hermes
Kimi	adhdev launch kimi	No verificado	Agente de codificación Kimi de Moonshot
OpenCode CLI	adhdev launch opencode	No verificado	Agente de codificación de terminal de código abierto

Por qué CLI importa

Los agentes CLI suelen ser la forma más rápida de mantener el trabajo en marcha porque:

• se mantienen cerca de tu repo y flujo de trabajo de shell
• funcionan bien con control de terminal remoto
• evitan roturas de UI específicas del IDE
• permiten que ADHDev transmita la sesión de terminal exacta, no una abstracción reconstruida

Si quieres el flujo de trabajo remoto más fiable hoy, los agentes CLI suelen ser la primera ruta a validar. Entre las promociones públicas actuales, Claude Code, Codex CLI y Cursor CLI tienen la evidencia más clara.

Lanzar un agente CLI

# Rutas predeterminadas sólidas
adhdev daemon
adhdev launch claude
adhdev launch codex
adhdev launch cursor-cli

# Proveedores CLI integrados adicionales
adhdev launch antigravity-cli
adhdev launch hermes-cli
adhdev launch kimi
adhdev launch opencode

Antes de lanzar, asegúrate de que el proveedor esté habilitado en la pestaña Providers de la máquina y de que Detect tenga éxito para el ejecutable configurado. Si el binario está instalado fuera del PATH predeterminado, configura primero una ruta/argumentos de ejecutable personalizados allí.

El daemon genera el proceso CLI con un PTY, transmite la salida al panel y reenvía tu entrada de vuelta al proceso.

Los lanzamientos ordinarios se tratan como sesiones nuevas. Si quieres continuidad, usa una ruta de reanudación explícita como el Historial o la recuperación de runtime alojado en lugar de depender de la reanudación automática implícita.

WARNING

Cada herramienta CLI gestiona su propia autenticación. ADHDev gestiona la sesión PTY y la capa de control remoto, no el flujo de inicio de sesión de la herramienta upstream.

Flujo de trabajo de terminal

Los proveedores CLI en ADHDev ahora usan la vista de terminal como flujo de trabajo principal. Eso significa que la terminal es la fuente de verdad para:

• salida y progreso
• prompts de aprobación
• flujo de ejecución de herramientas
• comportamiento de reconexión y scrollback

Vista de terminal

Los agentes CLI aparecen en el panel con una terminal interactiva completa impulsada por xterm.js:

• Renderizado TUI completo — colores, movimiento del cursor, barras de progreso y prompts de aprobación
• Entrada remota — escribe directamente desde el panel
• Restauración de scrollback — el búfer PTY se reproduce después de la reconexión
• Control apto para móvil — práctico para aprobaciones rápidas y supervisión ligera

Recuperación de sesión

Los runtimes CLI ya no se tratan como lanzamientos desechables de un solo uso. ADHDev mantiene una capa de runtime alojado para que las sesiones a menudo se puedan recuperar después de desconexiones o reinicios del daemon.

Esa ruta de recuperación está impulsada por el operador: los usuarios deben elegir explícitamente las acciones de Reanudar / Historial / recuperación de runtime alojado cuando quieran continuidad. Un lanzamiento nuevo normal no debería reabrir silenciosamente una sesión anterior.

Si una sesión CLI desaparece del panel principal, revisa:

• Pestañas ocultas
• Bandeja de actividad
• Historial
• la pestaña Hosted Runtimes de la máquina

Para recuperación desde la línea de comandos, empieza con la superficie de runtime principal orientada al usuario:

adhdev runtime list
adhdev runtime attach <runtimeTarget>
adhdev runtime recover <runtimeTarget>
adhdev runtime restart <runtimeTarget>
adhdev runtime snapshot <runtimeTarget>

<runtimeTarget> acepta el ID de sesión, la clave de runtime, el nombre para mostrar o un prefijo único mostrado en adhdev runtime list.

Si prefieres comandos más cortos para la ruta común, adhdev attach <runtimeTarget> y adhdev recover|resume <runtimeTarget> son atajos directos para la misma superficie de runtime.

Si necesitas diagnósticos de bajo nivel o controles explícitos del operador, usa:

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

Esta es la ruta correcta cuando el runtime todavía existe pero la sesión activa del panel está atascada o adjunta a la copia equivocada.

La profundidad del historial y la reanudación aún varía según el proveedor. Un CLI integrado puede lanzarse limpiamente y aun así permanecer como No verificado para los flujos de reanudación hasta que esa ruta se pruebe explícitamente.

Configuración del agente

Cada agente CLI admite configuración ajustable a través del botón de engranaje del panel:

Configuración	Descripción
Notificaciones	Mostrar notificaciones de cambio de estado
Auto Aprobar	Auto-aprobar la ejecución de herramientas donde se admita
Notificaciones de aprobación	Notificar cuando se necesita una aprobación
Alerta de generación larga	Avisar cuando un turno se ejecuta demasiado tiempo
Umbral de generación larga	Umbral en segundos (30–600)

CLI vs ACP

Característica	Agente CLI (PTY)	Agente ACP (stdio)
Interfaz	Sesión de terminal completa	Protocolo de chat estructurado
Renderizado	xterm.js / terminal en bruto	Markdown / bloques de contenido
Mejor ajuste	Flujos de trabajo de shell reales, herramientas TUI, supervisión remota	Agentes nativos de protocolo con eventos estructurados
Modelo de verificación	No verificado por defecto; validar por proveedor	No verificado por defecto; validar por proveedor

Solución de problemas

El agente no se lanza

• Verifica que la herramienta esté instalada localmente
• Habilita el proveedor en la pestaña Providers de la máquina y ejecuta Detect
• Configura una ruta/argumentos de ejecutable personalizados si el binario está fuera del PATH predeterminado
• Revisa la autenticación upstream o las claves de API
• Inspecciona la salud local con adhdev daemon:status

La terminal está en blanco

• La herramienta puede estar esperando entrada
• Revisa el estado de conexión en el panel
• Revisa las pestañas ocultas, la bandeja y el historial antes de iniciar una sesión duplicada
• Si el runtime sobrevivió, recupéralo a través de Hosted Runtimes en lugar de relanzar inmediatamente

La salida de terminal se ve mal

• Reinicia la sesión si la herramienta upstream dejó la terminal en mal estado
• Trata la vista de terminal como la salida canónica de los proveedores CLI
• Si el problema persiste, trátalo como un problema de compatibilidad de proveedor y revisa primero las páginas de compatibilidad

Próximos pasos

• Primeros pasos →
• Agentes ACP →
• Servidor MCP →
• Compatibilidad y advertencias →
• Solución de problemas →
• Problemas de proveedor →