Agentes CLI
Los agentes CLI son uno de los flujos de trabajo principales de ADHDev. Hoy ADHDev incluye 8 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.
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. El estado de verificación está actualmente bajo re-verificación completa — consulta Proveedores compatibles.
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 | No verificado | Agente de codificación Claude de Anthropic |
| Codex CLI | adhdev launch codex-cli | No verificado | Agente de terminal Codex de OpenAI |
| Cursor CLI | adhdev launch cursor-cli | No verificado | Flujo de trabajo de agente de terminal de Cursor |
| Grok CLI | adhdev launch grok-cli | No verificado | Agente de terminal Grok de xAI |
| 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 |
¿Quieres usar un agente CLI que no está en esta tabla? Consulta Proveedores personalizados para añadir uno tú mismo con un manifiesto de proveedor.
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. El estado de verificación de proveedores individuales está actualmente siendo rehecho — consulta Proveedores compatibles para el estado actual antes de confiar en una promoción específica.
Lanzar un agente CLI
# Rutas predeterminadas sólidas
adhdev daemon
adhdev launch claude
adhdev launch codex-cli
adhdev launch cursor-cli
# Proveedores CLI integrados adicionales
adhdev launch antigravity-cli
adhdev launch grok-cli
adhdev launch kimi
adhdev launch opencodeAntes 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.
Concesión previa de confianza de carpeta
kimi, grok-cli, codex-cli, claude-cli y antigravity-cli registran un esquema de confianza de carpeta con ADHDev, de modo que un lanzamiento nuevo en un directorio nuevo se salta el prompt único "¿Confías en esta carpeta?" de esa herramienta en lugar de quedarse esperándolo. La confianza se concede previamente usando el mismo almacén de confianza en el que la propia herramienta escribiría la primera vez que la aprobaste de forma interactiva.
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-duplicatesEsta 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 |
| Alertas de aprobación | Notificar cuando se necesita una aprobación |
| Alerta de sin progreso | Avisar cuando un turno no muestra progreso durante demasiado tiempo (antes etiquetada "Alerta de generación larga") |
| Umbral de sin progreso | Umbral en segundos antes de que se dispare la alerta de sin progreso |
Modos de auto-aprobación (1.0.60+)
Más allá del interruptor único on/off "Auto Aprobar" de arriba, cada proveedor CLI integrado ahora declara su propio conjunto de modos de auto-aprobación en el momento del lanzamiento — un selector que se muestra al iniciar una sesión, no la configuración del botón de engranaje. Cada modo lleva un nivel de riesgo para que sepas qué estás activando antes de lanzar:
| Riesgo | Significado |
|---|---|
| Seguro | Análisis interactivo de PTY — ADHDev responde a los prompts que reconoce; nada se omite a nivel de herramienta |
| Precaución | Se pasa al lanzamiento el propio flag "aceptar ediciones" / "auto" del proveedor — auto-aceptación más amplia, aunque limitada al proveedor |
| Peligroso | El flag completo de omisión de permisos del proveedor (por ejemplo, --permission-mode bypassPermissions de Claude Code, --auto de kimi) — el agente ejecuta comandos sin ningún prompt. ADHDev muestra un diálogo de confirmación antes de lanzar en este modo. |
Los modos disponibles difieren según el proveedor (provienen de los propios flags de CLI de ese proveedor), y el predeterminado es siempre el modo seguro e interactivo.
Descubrimiento de modelos (1.0.60+)
La lista del selector de modelos se descubre de forma diferente según el proveedor:
| Cómo | Proveedores |
|---|---|
| Ejecuta el propio comando de listado de modelos de la CLI en tiempo de ejecución | codex-cli, grok-cli, cursor-cli, antigravity-cli, opencode |
| Lee el archivo de configuración local del proveedor | kimi |
| No detectable — se usa tal cual la lista del manifiesto | claude-cli |
Las opciones de modelo de claude-cli (opus/sonnet/haiku/fable) son alias estables en lugar de slugs versionados, así que no cambian de la forma en que lo haría una lista descubierta.
Reporte de cuota
adhdev quota <provider> imprime la lectura actual de uso de un proveedor. adhdev quota refresh [providers...] pide al daemon en ejecución que realmente vuelva a obtener y actualizar su lectura en caché (lo que leen el enrutamiento y el panel), respetando cualquier periodo de enfriamiento por límite de tasa activo.
El reporte de cuota está disponible para: claude-cli, codex-cli, kimi, opencode, grok-cli, cursor-cli, antigravity-cli (las 7 CLI integradas).
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
La sesión muestra un prompt de aprobación sin nada que aprobar (1.0.60+)
Algunas CLI pueden bloquearse en un paso fuera de la propia terminal — el ejemplo más claro es el inicio de sesión basado en navegador de grok-cli. ADHDev ahora rastrea esto internamente como un estado distinto para que dicha sesión aparezca en tu bandeja de aprobaciones en lugar de leerse silenciosamente como inactiva o generando (aparece ahí como un elemento normal de espera, no como una insignia separada). Completa el paso externo (por ejemplo, termina el inicio de sesión en el navegador) y la sesión se reanuda con normalidad.