La CLI de tu agente murió al arrancar.
Aquí tienes exactamente por qué.
Una CLI de agente que no arranca es el fallo más desmoralizante de la codificación con IA: sin salida, sin stack trace, a veces solo un prompt que vuelve. CLI Doctor atrapa ese momento, lee lo que pasó de verdad y responde a la única pregunta que importa: qué se rompió y qué hago ahora.
Sabe el comando exacto que ejecutó AgentsRoom, qué flag vino de qué ajuste y qué imprimió la CLI antes de rendirse. Ese es el contexto que un resultado de buscador nunca tiene.
Un arranque fallido, el error real y un diagnóstico que nombra el ajuste responsable.
Las CLI de agentes se mueven rápido. Un flag desaparece en una versión menor, un binario se esfuma de tu PATH tras actualizar Node, una sesión caduca, un sandbox se niega a arrancar, un archivo de configuración escrito para otra herramienta acaba siendo leído. El resultado siempre es el mismo de tu lado: envías un prompt y no pasa nada.
Lo difícil nunca es el arreglo. Es saber cuál de las veinte cosas del comando de arranque es la que se rompió, y si viene de la app, de los ajustes de tu proveedor, de una anulación que pusiste en ese agente concreto hace tres semanas, o de que la propia CLI cambió por debajo.
CLI Doctor cierra ese hueco. Guarda un registro del comando exacto que se lanzó, etiqueta cada flag con el ajuste que lo inyectó, captura lo que la CLI imprimió y lo convierte todo en un diagnóstico corto con pasos concretos. Las comprobaciones deterministas se ejecutan siempre primero y mantienen la prioridad: la IA solo habla cuando la app no puede responder por sí sola.
Lo que obtienes en lugar de un terminal en blanco
Un resumen en lenguaje claro de lo que falló, no un stack trace que descifrar. Una o dos frases que nombran la causa real.
Pasos siguientes concretos y ordenados. Cada uno puede llevar un atajo al panel de ajustes exacto, al comando de reinstalación o a un relanzamiento, así que nunca te toca buscar dónde vive la opción.
Procedencia de los flags: cada token del comando de arranque se atribuye a su origen, así que la respuesta puede decir "este flag viene del modo Autónomo en Ajustes" en lugar de adivinar.
El mismo trato para los comandos de desarrollo. Cuando tu comando de build, de test o de servidor falla en un terminal, el diagnóstico está a un clic, y desde ahí puedes pasarle todo el asunto a un agente DevOps.
Cómo se produce un diagnóstico
Por capas a propósito: primero corren las comprobaciones baratas y seguras, la IA es el último recurso.
AgentsRoom registra el arranque real
En el momento único en que se crea un terminal, se registra el comando completo: binario, flags, modelo, opciones. Ese registro es lo que hace posible un diagnóstico preciso más tarde, y cubre todas las vías por las que puede arrancar un agente, incluido un lanzamiento disparado desde el teléfono o desde un ticket del backlog.
Las comprobaciones deterministas hablan primero
Un binario que falta, un flag que la CLI ya no acepta, una sesión sin autenticar, una versión obsoleta: son veredictos conocidos y seguros. Se responden directamente con un banner y un botón de arreglo. Sin llamada a la IA, sin esperas.
Un arranque sospechoso se corrobora, no se da por hecho
Si el fallo no es uno de los casos conocidos, AgentsRoom busca un patrón de error en los primeros segundos y luego comprueba qué se está ejecutando realmente en el terminal. Una CLI que simplemente tarda en arrancar, o que está ocupada instalando sus servidores MCP en la primera ejecución, no es un fallo y se descarta.
Se diagnostica el contexto ya filtrado
Solo entonces entra la IA, con el extracto del error, el comando saneado y el mapa de procedencia de los flags. Los system prompts, los valores que parecen secretos y los argumentos entrecomillados largos se filtran en tu máquina antes de enviar nada.
Recibes un resumen y unos pasos, y decides tú
El diagnóstico aparece en el terminal. Nunca se ejecuta nada por ti: un botón de acción abre los ajustes pertinentes, propone un relanzamiento o muestra el comando de instalación, y tú sigues siendo quien lo pulsa.
De dónde sale la respuesta
CLI Doctor lee las mismas superficies que tú configuras. Estas son las tres que provocan la mayoría de los fallos de arranque.
Los flags de arranque vienen de los valores por defecto del proveedor, del modo autónomo, de un modelo fijado o de una anulación por agente. Aquí es donde suele mandarte el diagnóstico.
Saber másLos comandos de build, de test y de servidor reciben el mismo diagnóstico, a golpe de clic en vez de automáticamente, porque si no un bucle de watch que falla estaría preguntando para siempre.
Saber másSaber que un agente está pensando, ha terminado, está esperando o está muerto es lo que le dice a AgentsRoom que algo ha ido mal, para empezar.
Saber másConstruido con los límites evidentes
FAQ
¿Qué CLI de agentes cubre CLI Doctor?
Todas. El registro de arranque se escribe en el único punto donde AgentsRoom crea un terminal, así que Claude Code, Codex CLI, GitHub Copilot CLI, Antigravity CLI, OpenCode, Aider, Grok Build, Mistral Vibe y Kimi Code están todos cubiertos, junto con los agentes lanzados desde el compañero móvil o desde un ticket del backlog.
¿Envía la salida de mi terminal a un servidor?
Envía un extracto filtrado del error de arranque, el comando de arranque saneado y el mapa de procedencia de los flags, y solo cuando se produce realmente un diagnóstico. Los system prompts, los valores de entorno que parecen secretos y los argumentos entrecomillados largos se eliminan antes en tu máquina. Tu código fuente nunca forma parte de ello, y el diagnóstico automático se puede desactivar por completo en Ajustes, en Privacidad y datos.
¿Va a ejecutar comandos o cambiar mis ajustes por su cuenta?
No. Un paso puede llevar un atajo que abre el panel de ajustes adecuado, propone relanzar el agente o muestra el comando de instalación para copiar. Ejecutar algo siempre es acción tuya.
¿Qué es la procedencia de los flags, en concreto?
AgentsRoom monta el comando de arranque a partir de varias capas: los valores por defecto del proveedor, el modo autónomo, el modelo que elegiste, un esfuerzo de razonamiento, una anulación de CLI por agente, y más. La procedencia de los flags etiqueta cada token del comando final con la capa que lo puso ahí, así que el diagnóstico puede señalar el interruptor exacto que hay que cambiar en lugar de describir el flag en abstracto.
¿Se dispara con cualquier error?
No, y es deliberado. En un terminal de agente se dispara una vez por episodio de arranque fallido, y solo cuando el fallo está corroborado: una CLI que simplemente tarda en arrancar, o que está ocupada instalando sus servidores MCP en la primera ejecución, se descarta en vez de diagnosticarse. En los terminales de comandos de desarrollo el diagnóstico es solo a golpe de clic, porque un bucle de watch que falla vuelve a emitir su error continuamente.
¿Está disponible en el plan gratuito?
Sí, con una cuota mensual. Plus la sube y Pro es ilimitado en la práctica. Los veredictos deterministas, que cubren los fallos más habituales como un binario que falta o un flag rechazado, no consumen cuota: nunca llaman a un modelo.
¿Qué pasa con un agente que corre en una máquina remota por SSH?
El proceso en primer plano de tu lado es el propio cliente SSH, así que una CLI remota que muere parece sana desde aquí y el episodio se salta. Es un compromiso deliberado: mejor un diagnóstico que no llega que uno equivocado con aire de certeza. Las comprobaciones deterministas siguen aplicándose en el lado remoto de la conexión.
¿En qué se diferencia de pegar el error en un chatbot?
Un chatbot solo ve el mensaje que le pegas. CLI Doctor tiene además el comando exacto que se ejecutó, la procedencia de cada flag que lleva, el proveedor y el modelo en uso y el estado del proceso, sin que tú montes nada de eso. Ese contexto es lo que convierte una respuesta genérica en el nombre del ajuste que hay que cambiar.
También te puede interesar
Multi-Provider
AgentsRoom soporta 9 proveedores de codificación IA: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe y Kimi Code. Asigna un proveedor diferente por agente, cambia de proveedor en medio de una conversación y conserva todo el contexto con handoff automático. La mejor herramienta de codificación IA multi-provider.
Seguimiento de estado
Controle el estado de cada agente Claude Code de un vistazo. Indicadores con colores para los estados pensando, completado, inactivo y esperando respuesta. Cronometros, resumenes de actividad y contadores por proyecto.
Terminales dev
Ejecuta tu build, tus tests y tu servidor de desarrollo en la misma ventana que tus agentes, con una campana cuando un comando largo termina y un diagnóstico cuando falla.
Restaurar agentes y terminales
Vuelve a abrir la app y encuentra tus agentes y tus terminales dev donde los dejaste, con la opción de retomar la conversación anterior de la CLI.
Mensajes de Commit AI
Un generador de mensajes de commit AI integrado en AgentsRoom. Haz clic en la chispa en el campo de commit, lee el diff real de git y escribe un mensaje de commit limpio en formato de Conventional Commits. Escribe un borrador, obtén una reescritura. Las reglas de formato de tu equipo se aplican en cada generación.
Sugerencias de Agentes
¿No estás seguro de qué agente de IA usar? Describe tu tarea en lenguaje sencillo y AgentsRoom sugiere el agente adecuado: desde tu sala, los 14 roles integrados o más de 260 expertos del catálogo, con una razón en una línea. Un clic asigna la tarea.
Deja de adivinar por qué tu agente no arranca
AgentsRoom lee el arranque, nombra al culpable y te da el arreglo. Descarga gratuita en macOS, Windows y Linux.
App complementaria: supervisa tus agentes en movimiento
Usa Claude, Codex, Antigravity CLI u otro proveedor de IA.
Envía bugs y peticiones directamente a tu backlog público.
Un vistazo a AgentsRoom en acción.