AI OS CLI para Claude Codey cualquier agente de IA
La CLI de AI OS te conecta a la misma plataforma desde la línea de comandos. Son las mismas 16 herramientas, para que tú o tu agente puedan acceder a tu carpeta, el catálogo, los planos y las guías sin abrir un chat.
La CLI de AI OS ofrece las mismas 16 herramientas que el servidor MCP, ejecutadas como comandos en lugar de a través de un chat.
Aunque parezca un paso atrás y no sea la opción más frecuente, es la única interfaz que funciona sin necesidad de tener ninguna IA abierta. Esto es crucial al configurar varias carpetas o al revisarlas antes de que un agente las procese.
Considérelo la misma caja de herramientas, pero con un mango diferente. Esta página le indicará cuándo usar cada una.
- Qué es la CLI de AI OS y cómo se relaciona con el servidor MCP
- Qué puede ejecutar desde la línea de comandos
- Cada herramienta y los elementos que modifica
- Cuándo usar la CLI y cuándo usar MCP
- Qué hará y qué no hará con sus archivos
Empecemos por lo que realmente es.
¿Qué es la CLI de AI OS?
La CLI de AI OS incluye las mismas 16 herramientas como comandos. Se instala una vez y, a partir de ahí, tanto usted como su agente pueden ejecutarlas.
Es la única interfaz que funciona sin necesidad de tener ninguna IA abierta, lo cual es ideal cuando está configurando varias carpetas o revisando una antes de que la vea un agente.
Es el mismo software que el servidor MCP, en el mismo paquete, y lee la misma lista de herramientas. Al instalar uno, obtiene ambos.
Qué puedes pedir
Una vez conectado, hablas con tu agente con normalidad. Cada una de estas acciones ejecuta una herramienta de la lista inferior.
“Audit my AI OS.”
os_audit
“What is wrong with my CLAUDE.md?”
os_audit, context_read
“My agent keeps losing my voice. Fix it.”
blueprint_get, context_write
“Set up an AI OS here and interview me for it.”
os_init, blueprint_get
“Is there a skill for writing newsletters?”
skills_search
“What actually goes in a context file?”
docs_search
“Which tier am I on, and what would Pro add?”
whoami, upgrade_info
“Check nothing in my folder is stale.”
os_audit
Todo tu AI OS, desde la línea de comandos
16 comandos, agrupados por lo que modifican. 3 de ellos cubren todo el catálogo de habilidades, en lugar de 1 comando por habilidad, lo que lo mantiene manejable a medida que el catálogo crece.
Auditoría
Califica tu carpeta y te dice qué arreglar, de lo peor a lo mejor. Cada hallazgo indica qué hacer a continuación.
Contexto
Lee y escribe los archivos que contienen quién eres, cómo suenas y qué vendes.
Plantillas
El método y una plantilla para cada archivo, para que lo que se escriba siga tu método.
Habilidades
Busca en el catálogo e instala una habilidad en tu AI OS.
Guías
Las respuestas provienen de las guías publicadas aquí, no de la memoria.
Cuenta
Tu nivel, tu asignación y lo que añade el siguiente nivel.
Every command, and what it is for
Las 16. El comando es el nombre de la herramienta con guiones en lugar de guiones bajos, así que `os_audit` es `aios-cli os-audit`. Añade `--help` a cualquiera de ellas para ver qué requiere.
| Tool | What it is for | Where it runs | Your files |
|---|---|---|---|
| os_audit | Te dice qué está mal con tu AI OS y qué arreglar primero. Ejecuta esto antes que nada, y antes de seguir cualquier consejo sobre tu configuración. | Your machine | Reads |
| os_init | Inicia un nuevo AI OS en una carpeta, para que tu agente tenga dónde guardar lo que aprende sobre ti. Escribe plantillas vacías a propósito y nunca toca un archivo que ya exista. | Your machine | Adds |
| os_validate | Confirma que tus archivos pueden ser leídos por un agente. Un front matter que se abre y nunca se cierra hace que un archivo sea invisible en lugar de estar roto, por lo que nada te avisa. | Your machine | Reads |
| os_update | Actualiza tu AI OS a la versión actual y deja intacto todo lo que escribiste. Compara por hash, por lo que tus propias ediciones se informan en lugar de sobrescribirse. | Your machine | Can replace |
| context_list | Muestra la forma de tu AI OS de un vistazo: qué archivos de contexto existen, cuánto hay realmente en cada uno y cuándo fue la última vez que se modificó. | Your machine | Reads |
| context_read | Abre un archivo completo, para que una reescritura se base en lo que ya dijiste en lugar de reemplazarlo con una suposición. | Your machine | Reads |
| context_write | Guarda lo que tu agente aprendió sobre ti en el archivo que lo contiene. Un nuevo archivo se escribe de inmediato. Reemplazar uno que ya tiene contenido te pregunta primero. | Your machine | Can replace |
| blueprint_list | Muestra todas las guías de escritura y plantillas en la plataforma, para que tu agente sepa qué ayuda existe antes de empezar a escribir algo. | Either | Reads |
| blueprint_get | Entrega a tu agente el método para un archivo, con una plantilla y ejemplos prácticos. Esto es lo que hace que escriba a tu manera en lugar de recurrir a sus valores predeterminados. | Either | Reads |
| skills_search | Encuentra una habilidad prefabricada para algo que quieres que haga tu AI OS, para que no tengas que describirla desde cero cada vez. | Either | Reads |
| skills_get | Te muestra lo que una habilidad realmente añade, antes de que se acerque a tu carpeta. | Either | Reads |
| skills_install | Instala una habilidad en tu AI OS, para que cada agente que lea la carpeta pueda usarla. Se niega a reemplazar una habilidad con el mismo nombre a menos que se lo indiques. | Your machine | Adds |
| docs_search | Responde una pregunta sobre AI OS a partir de las guías publicadas aquí, en lugar de lo que el modelo recuerde a medias. | Either | Reads |
| docs_get | Lee una guía completa, para cuando un extracto no es suficiente para actuar. | Either | Reads |
| whoami | Indica en qué cuenta estás, qué puedes usar y cuánto de tu asignación diaria queda. Pregunta esto primero cuando una herramienta se niegue a funcionar. | Either | Reads |
| upgrade_info | Indica qué incluye cada nivel y qué te añadiría el siguiente. | Either | Reads |
Dónde se ejecuta una herramienta depende del servidor al que te conectes, no de la aplicación que uses. El servidor local se ejecuta en tu propia máquina y puede ver tu carpeta, por lo que incluye las 16 herramientas. El servidor alojado se ejecuta en el nuestro y no tiene una copia de tu carpeta, por lo que incluye las 8 que no la necesitan.
Vale la pena ser precisos al respecto, porque es fácil confundirse. Un agente en la nube no está desconectado de tus archivos. Claude Cowork accede a las carpetas que le adjuntas y escribe en ellas con sus propias herramientas, por lo que las 8 alojadas son realmente útiles allí. Lo que un agente en la nube no puede hacer es iniciar un servidor en tu máquina.
Nada marcado como «tu máquina» tiene costo, y nada de tus archivos se envía a ningún lugar. Esas herramientas funcionan con la sesión cerrada y sin conexión, por eso la auditoría no cuesta nada y nunca lo hará.
AI OS viene en 3 niveles: AI OS Starter, AI OS Pro y AI OS Max. Todas las herramientas aquí listadas están disponibles en AI OS Starter hoy. Lo que un nivel de pago añade es la profundidad de la respuesta en lugar de una lista más larga de herramientas.
MCP o la CLI
Ambos provienen de la misma instalación y ambos leen una lista de herramientas, por lo que ninguno puede tener una herramienta que le falte al otro. Eso se prueba en lugar de ser intencional: la misma auditoría ejecutada a través de ambos devuelve una respuesta idéntica byte por byte. Lo que cambia es cuándo pagas por ello y quién escribe.
Lo que te cuesta cada uno
Las mismas 16 herramientas de cualquier manera. Difieren en cuándo pagas por ellas.
| Servidor MCP | CLI | |
|---|---|---|
| Loaded every turn | 3,315 tokens | 97 tokens |
| Loaded when your AI OS comes up | Nada más | 1,595 más, una vez |
| Tools | 16 | 16 |
| With AIOS_READ_ONLY=1 | 2,364 tokens, 12 herramientas | Los mismos 12 |
| Works on the web and on your phone | Sí, a través del servidor alojado, con 8 herramientas | No. No hay línea de comandos allí |
| Works with no AI open at all | No. MCP es cómo un agente accede a una herramienta | Sí. Esta es la única interfaz que lo hace |
| You start it by | Pidiendo algo con tus propias palabras | Escribiendo un comando |
Un servidor MCP envía su lista completa de herramientas al modelo en cada turno, ya sea que tu AI OS se active o no. Ese es el precio de estar conectado, antes de que pidas algo. La CLI no cuesta nada hasta que se la llama: lo que aparece en la conversación es 1 línea que la describe, y el resto llega solo cuando tu agente la busca.
En más de 20 turnos donde tu AI OS se activa una vez, eso es 66,300 tokens frente a 3,535. Cuando toda la conversación es tu AI OS, la brecha se cierra y el servidor ofrece una mejor experiencia, porque preguntas en lenguaje natural en lugar de recordar comandos.
La mayor parte de los 3,315 no es algo que cualquiera pueda eliminar. Es el protocolo que escribe 16 herramientas como JSON Schema, y cualquier servidor con esta cantidad de herramientas paga aproximadamente lo mismo. Apágalo los días que no lo uses, y cada cliente tiene una forma de hacerlo.
El número se mantiene fijo a medida que el catálogo crece, porque una habilidad se obtiene cuando tu agente la solicita en lugar de enviarse cuando se conecta. Un servidor con 1 herramienta por habilidad pasaría 50,000 tokens en un año, y no habría vuelta atrás.
Cada número aquí provino de un intercambio real con esta compilación, contado con un tokenizador en lugar de estimado a partir de la longitud del texto.
Cómo es usar cada uno
| Lo que estás haciendo | Con MCP | Con la CLI |
|---|---|---|
| Auditing a folder before you trust it | Le pides a tu agente que audite tu AI OS. Te lee el informe y te ofrece arreglar lo primero que encontró. | Ejecutas aios-cli os-audit y lees el informe tú mismo. Este es el que quieres cuando revisas varias carpetas, o revisas una antes de que un agente la haya visto. |
| Fixing a voice file that is wrong | Tu agente obtiene el plano de voz, te entrevista y escribe el archivo, todo dentro de la conversación. | Obtienes el plano y escribes el archivo tú mismo, o le pides a un agente que pueda ejecutar un comando que lo haga por ti. |
| Installing a skill | Dices lo que quieres que haga tu AI OS, y tu agente busca en el catálogo y lo instala. | Ejecutas aios-cli skills-search, luego aios-cli skills-install. |
| Setting up a second AI OS | Abres una conversación en esa carpeta y preguntas. | Ejecutas aios-cli os-init y sigues. Más rápido cuando haces varios. |
| Proving they really are the same thing | La lista de herramientas que recibe tu cliente. | aios-cli schema os-audit imprime el esquema exacto que se envía a un cliente MCP, para que puedas compararlos tú mismo. |
Usa MCP como predeterminado. Es el que te permite pedir algo con tus propias palabras y que se haga, que es el objetivo de tener un AI OS.
Usa la CLI cuando no haya una conversación de por medio. Si estás configurando varias carpetas, o quieres revisar una antes de que un agente la vea, o prefieres no llevar la lista de herramientas en cada conversación.
La mayoría de la gente termina usando ambos, y ambos provienen de la misma instalación.
Lo que detecta la auditoría
Empieza por aquí, hagas lo que hagas. Estos son los problemas que no puedes ver en un listado de archivos, por eso existe la auditoría.
Una credencial en un archivo de contexto
Pegado una vez y leído por cada agente desde entonces. Se informa redactado, nunca completo.
Marcadores de posición que nadie rellenó
Tu agente ha estado leyendo [Your name] como un hecho sobre ti durante meses.
Archivos que existen y no dicen nada
Un archivo de voz vacío es peor que uno que falta, porque parece que ha sido gestionado.
Contexto demasiado largo para sobrevivir
Nombrados con recuentos de palabras, para que sepas qué archivo cortar y aproximadamente cuánto.
Referencias a archivos que ya no existen
Tu agente los sigue, no encuentra nada y continúa sin avisarte.
Cualquier cosa obsoleta
Clasificado por su importancia, no solo por su antigüedad.
Lo que hará y lo que no hará
Está apuntando un agente a la carpeta que describe su negocio, por lo que vale la pena leer esto antes de conectar cualquier cosa.
- Sus archivos de contexto nunca salen de su máquina. La auditoría los lee donde están y no envía ninguno a ningún sitio. Solo el conjunto de reglas viaja, y viaja hacia usted.
- Las escrituras están activadas por defecto. Un servidor cuya cada escritura necesita un indicador le enseña a dejar ese indicador activado permanentemente, lo que parece protección y no lo es.
- Cualquier cosa que pueda reemplazar trabajo que no puede recuperar es rechazada hasta que la confirme. Eso es
os_updatey unacontext_writesobre un archivo que ya tiene contenido. - Establezca
AIOS_READ_ONLY=1y las 4 herramientas que escriben nunca se ofrecerán. Úselo cuando apunte un agente en el que no confía plenamente a su carpeta. - Establezca
AIOS_AUDIT_LOGa un archivo y cada intento de escritura se registrará, tanto los que fueron rechazados como los que se ejecutaron. - Una credencial encontrada en un archivo de contexto se reporta redactada, nunca completa, para que el hallazgo no se convierta en una segunda copia de la fuga.
Niveles
AI OS está disponible en 3 niveles: AI OS Starter, AI OS Pro y AI OS Max. El nivel pertenece a tu cuenta y no a algo que hayas instalado, por lo que una actualización cambia lo que tu agente puede hacer en su siguiente solicitud, sin necesidad de reconectar nada.
Todas las herramientas de esta página están disponibles en AI OS Starter. Lo que añade un nivel de pago es profundidad en lugar de una lista más larga: el conjunto completo de reglas de auditoría, planos adaptados al tipo de negocio que realmente tienes y una asignación diaria más alta para las herramientas que acceden a nuestros servidores.
Las asignaciones no se publican aquí todavía, porque la restricción aún no está implementada. Todas las herramientas se envían hoy como AI OS Starter. Esta página incluirá los números el día que sean reales, en lugar de una tabla de cifras que no se aplican.
Límites
Las herramientas locales nunca se miden. Leen y escriben en su propia carpeta, nunca llegan a nuestros servidores y un límite en ellas le costaría algo a usted sin ahorrarnos nada a nosotros.
Las herramientas alojadas se contabilizan dentro de una asignación diaria en su cuenta. Cada una tiene un peso, por lo que una herramienta costosa no puede ejecutarse 500 veces dentro de un límite diseñado para herramientas económicas.
Cuando se agote, el rechazo indicará la hora de reinicio en lugar de fallar silenciosamente. Pregúntele a su agente whoami en cualquier momento y le dirá cuánto le queda.
Configuración
Ninguna de estas es obligatoria. Existen para cuando se desea algo distinto a la configuración predeterminada.
| Configuración | Función |
|---|---|
| AIOS_API_KEY | Una clave para que una máquina pueda iniciar sesión sin navegador. Normalmente, nunca se configura. aios-cli login lo gestiona y la clave nunca es visible. |
| AIOS_SESSION_PATH | Dónde se almacena el inicio de sesión. Por defecto, es ~/.aios/session.json. |
| AIOS_OS_PATH | ¿Cuál es la carpeta de su AI OS? Por defecto, es su ubicación actual, subiendo hasta la carpeta CLAUDE.md, AGENTS.md o context más cercana, de la misma forma en que git encuentra su raíz. |
| AIOS_READ_ONLY | Establézcalo en 1 y ninguna herramienta de escritura será ofrecida. 12 herramientas en lugar de 16. |
| AIOS_AUDIT_LOG | Un archivo al que se añade cada intento de escritura, tanto los permitidos como los rechazados. |
| AIOS_API_URL | Apúntelo a un lugar diferente de api.aios.guide. Para pruebas. |
| AIOS_REQUEST_TIMEOUT_MS | Cuánto tiempo esperar por una respuesta antes de rendirse. Por defecto, 30000. |
Qué significan los números
Un comando finaliza con uno de estos códigos. Tu agente los interpreta para que no tengas que hacerlo.
| Código | Significado | Qué sucedió |
|---|---|---|
| 0 | Hecho | Funcionó correctamente. |
| 2 | Uso | El comando era incorrecto, faltaba un argumento o se rechazó una escritura porque no la habías confirmado. |
| 3 | No encontrado | La habilidad, el plano o la guía que solicitaste no existen. |
| 4 | Iniciar sesión | No has iniciado sesión o la sesión ya no es válida. |
| 5 | Servidor | Algo salió mal de nuestro lado o en la red. |
| 7 | Límite | Has agotado el límite diario para las herramientas alojadas. El mensaje indica cuándo se restablece. |
| 10 | No configurado | Aún no hay nada configurado. Ejecuta aios-cli login. |
¿Tienes más preguntas?
AI OS se conecta a través de MCP, el Protocolo de Contexto del Modelo. MCP es un estándar abierto que permite a un agente de IA acceder a herramientas externas.
Solo tienes que añadir el servidor una vez. Después de eso, tu agente puede auditar tu AI OS, leer y escribir tus archivos de contexto, obtener la guía de escritura para un archivo antes de redactarlo y buscar en el catálogo de habilidades, todo dentro de una misma conversación.
MCP es una forma estandarizada para que un agente de IA utilice herramientas que no están integradas en él. Piensa en ello como un plugin que funciona en todas partes, en lugar de una vez por aplicación.
Configuras AI OS una sola vez. La misma conexión funciona entonces en Claude, ChatGPT, Cursor, Codex y cualquier otro agente en esta página.
La CLI tiene las mismas 16 herramientas que los comandos de shell. Ambas interfaces leen una única lista de herramientas, por lo que ninguna puede tener una herramienta que la otra no tenga.
Te comunicas con ella de cualquier manera. Con MCP, tu agente llama a la herramienta directamente. Con la CLI, escribes `aios-cli os-audit`, o le pides a un agente que pueda ejecutar un shell que lo escriba por ti.
La CLI añade algo que MCP no puede hacer: funciona sin ningún agente, por lo que puedes incluirla en un script, en CI o canalizar su JSON a jq. La mayoría de la gente usa ambas, y ambas provienen de la misma instalación.
Funciona cualquier agente que hable MCP, lo que incluye los 11 de esta página y cualquier otro que acepte una URL de servidor. Lo que cambia es dónde se ejecuta el agente.
- 8 agentes se ejecutan en tu máquina. Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, OpenClaw y Hermes obtienen las 16 herramientas, porque pueden leer y escribir en tu carpeta. Los 8 también pueden ejecutar la CLI.
- 3 agentes se ejecutan en la nube. Claude Cowork, ChatGPT y Grok Bot se conectan a través de internet, por lo que priorizan las 8 herramientas que no necesitan un sistema de archivos. Cowork aún puede acceder a tus archivos a través de la aplicación Claude Desktop, y Grok Bot puede ejecutar comandos en tu máquina una vez que lo permitas en su configuración.
Audita tu AI OS y luego te ayuda a solucionar lo que encuentra. Todas las demás herramientas existen para apoyar eso.
- La auditoría califica tu carpeta y te indica qué corregir, de lo peor a lo mejor. Cada hallazgo te dice qué hacer a continuación.
- Las herramientas de contexto leen y escriben quién eres, cómo te expresas y qué vendes.
- Los planos le dan a tu agente el método y una plantilla para cada archivo, para que escriba a tu manera en lugar de la suya.
- Las herramientas de habilidades buscan en el catálogo e instalan una habilidad en tu OS.
- La herramienta de guías responde preguntas basándose en lo publicado aquí, en lugar de la memoria.
- Las herramientas de cuenta informan tu nivel, tu asignación y lo que añade el siguiente nivel.
La auditoría detecta los problemas que no puedes ver en un listado de archivos. Esa es la razón de su existencia.
- Encuentra credenciales pegadas en un archivo de contexto y leídas por cada agente desde entonces. Las reporta redactadas, nunca completas.
- Encuentra marcadores de posición de plantilla que nadie rellenó. Tu agente los ha estado leyendo como hechos.
- Encuentra archivos que existen y no dicen nada. Un archivo de voz vacío es peor que uno que falta, porque parece que se ha gestionado.
- Encuentra contexto tan largo que el final se cae de la ventana.
- Encuentra referencias que apuntan a archivos que no existen.
No. Pegas la URL e inicias sesión, o ejecutas `aios-cli login` y terminas en el navegador que se abre. De cualquier manera, nunca verás una clave.
Todas las herramientas locales funcionan sin iniciar sesión, incluida la auditoría. Iniciar sesión añade el catálogo, los planos y las guías.
Grok es el que debes verificar antes de empezar. xAI documenta los conectores MCP personalizados en grok.com/connectors, y dice que completes cualquier inicio de sesión que el servidor solicite allí. La propia documentación de Grok Bot aún no cubre la adición de un servidor MCP personalizado.
El servidor MCP y la CLI de AI OS están licenciados bajo la Licencia Elástica 2.0. Puedes leer el código fuente, modificarlo y usarlo en tu propio negocio en tantas máquinas y proyectos como desees.
Hay 2 cosas que no puedes hacer. No puedes ofrecerlo a otras personas como un servicio alojado o gestionado, y no puedes mover, cambiar o eludir las comprobaciones de nivel.
Esto lo convierte en código fuente disponible en lugar de código abierto, lo cual es una diferencia real y vale la pena decirlo claramente. El AI OS Starter Kit es un repositorio separado con su propia licencia.
No. La auditoría lee tus archivos en tu máquina y no envía ninguno de ellos a ningún lugar. Solo se descarga el conjunto de reglas, y tu contenido nunca viaja en la otra dirección.
Esta es una propiedad del código, no una promesa en una página. Nada en la parte que lee tus archivos tiene permitido hacer una solicitud de red, y una prueba en el repositorio lo garantiza.
Las 16 herramientas cuestan aproximadamente 3,659 tokens. Esa cifra se mide a partir de una conexión real, no es una estimación, y el README te da el comando para verificarlo tú mismo.
El número se mantiene constante a medida que el catálogo crece. Las habilidades se obtienen cuando tu agente las solicita, en lugar de enviarse en el momento de la conexión. Un servidor con 1 herramienta por habilidad pasaría 50,000 tokens en un año.
Nada para empezar, y no necesitas una cuenta. AI OS Starter incluye todas las herramientas locales sin límite, porque esas herramientas nunca tocan nuestros servidores.
Las herramientas alojadas tienen una asignación diaria. AI OS Pro y AI OS Max aumentan esa asignación, añaden las reglas de auditoría más completas y añaden planos adaptados a tu negocio.
Sí. Úsalo en tu propio negocio como quieras, en tantas máquinas y proyectos como desees. Está publicado en npm y se ejecuta en Docker, por lo que se adapta a donde ya trabajas.
Establece `AIOS_READ_ONLY=1` para eliminar cada escritura de la lista de herramientas cuando apuntes un agente en el que no confías completamente a tu carpeta. Establece `AIOS_AUDIT_LOG` para registrar cada intento de escritura, tanto los rechazados como los ejecutados.
También hay una API, por lo que un agente nunca es la única forma de acceder.