AI OS CLI per Claude Codee qualsiasi agente AI
La CLI di AI OS ti connette alla stessa piattaforma dalla riga di comando. Sono gli stessi 16 strumenti, così tu o il tuo agente potete accedere alla vostra cartella, al catalogo, ai blueprint e alle guide senza aprire una chat.
La CLI di AI OS offre gli stessi 16 strumenti del server MCP, eseguiti come comandi anziché tramite una chat.
Potrebbe sembrare un passo indietro, e nella maggior parte dei casi non è la scelta più immediata. Tuttavia, è l'unica interfaccia che funziona senza alcuna IA aperta, il che è fondamentale quando si configurano diverse cartelle o se ne controlla una prima che un agente la esamini.
Consideratela quindi come la stessa cassetta degli attrezzi con un manico diverso. Questa pagina vi mostra quando ogni manico è quello giusto.
- Cos'è la CLI di AI OS e come si relaziona al server MCP
- Cosa si può eseguire con essa dalla riga di comando
- Ogni strumento e cosa fa ciascuno
- Quando usare la CLI e quando usare MCP
- Cosa farà e non farà ai vostri file
Cominciamo con ciò che è realmente.
Cos'è la CLI di AI OS
La CLI di AI OS include gli stessi 16 strumenti disponibili come comandi. La installi una volta e poi tu o il tuo agente potete eseguirli.
È l'unica interfaccia che funziona senza alcuna IA aperta, il che è ideale quando stai configurando diverse cartelle o controllandone una prima che un agente la esamini.
È lo stesso software del server MCP, nello stesso pacchetto, che legge lo stesso elenco di strumenti. Installandone uno, ottieni entrambi.
Cosa puoi chiedere
Una volta connesso, puoi parlare normalmente con il tuo agente. Ognuno di questi esegue uno strumento dall'elenco più in basso.
“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
Tutto il tuo AI OS, dalla riga di comando
16 comandi, raggruppati per area d'intervento. 3 di questi coprono l'intero catalogo di competenze, anziché un comando per competenza, il che ne facilita la gestione man mano che il catalogo si espande.
Verifica
Valuta la tua cartella e ti indica cosa correggere, partendo dal più critico. Ogni rilevazione suggerisce i passi successivi.
Contesto
Legge e scrive i file che definiscono chi sei, il tuo tono di voce e cosa vendi.
Progetti
Il metodo e un modello per ogni file, così ciò che viene scritto segue la tua metodologia.
Competenze
Cerca nel catalogo e installa una competenza nel tuo AI OS.
Guide
Le risposte provengono dalle guide qui pubblicate, non dalla memoria.
Account
Il tuo livello, il tuo plafond e cosa aggiunge il livello successivo.
Every command, and what it is for
Tutti e 16. Il comando è il nome dello strumento con trattini al posto dei trattini bassi, quindi `os_audit` è `aios-cli os-audit`. Aggiungi --help a qualsiasi di essi per vedere cosa richiede.
| Tool | What it is for | Where it runs | Your files |
|---|---|---|---|
| os_audit | Ti dice cosa non va nel tuo AI OS e cosa risolvere per primo. Esegui questo prima di qualsiasi altra cosa, e prima di accettare consigli da chiunque sulla tua configurazione. | Your machine | Reads |
| os_init | Avvia un nuovo AI OS in una cartella, in modo che il tuo agente abbia un posto dove mettere ciò che impara su di te. Scrive intenzionalmente modelli vuoti e non tocca mai un file già esistente. | Your machine | Adds |
| os_validate | Conferma che i tuoi file possono effettivamente essere letti da un agente. Un front matter che si apre e non si chiude rende un file invisibile anziché danneggiato, quindi nulla ti avvisa. | Your machine | Reads |
| os_update | Aggiorna il tuo AI OS alla versione corrente e lascia intatto tutto ciò che hai scritto tu stesso. Confronta tramite hash, quindi le tue modifiche vengono segnalate anziché sovrascritte. | Your machine | Can replace |
| context_list | Mostra la struttura del tuo AI OS a colpo d'occhio: quali file di contesto esistono, quanto c'è realmente in ognuno e quando è stato modificato l'ultima volta. | Your machine | Reads |
| context_read | Apre un file per intero, in modo che una riscrittura si basi su ciò che hai già detto invece di sostituirlo con un'ipotesi. | Your machine | Reads |
| context_write | Salva ciò che il tuo agente ha imparato su di te nel file che lo contiene. Un nuovo file viene scritto immediatamente. La sostituzione di uno che ha già contenuto ti chiede prima. | Your machine | Can replace |
| blueprint_list | Mostra ogni guida di scrittura e modello sulla piattaforma, in modo che il tuo agente sappia quale aiuto esiste prima di iniziare a scrivere qualsiasi cosa. | Either | Reads |
| blueprint_get | Fornisce al tuo agente il metodo per un file, con un modello ed esempi pratici. Questo è ciò che lo fa scrivere a modo tuo invece di ricadere sui suoi valori predefiniti. | Either | Reads |
| skills_search | Trova una skill già pronta per qualcosa che vuoi che il tuo AI OS faccia, così non devi descriverla da zero ogni volta. | Either | Reads |
| skills_get | Ti mostra cosa aggiunge effettivamente una skill, prima che si avvicini alla tua cartella. | Either | Reads |
| skills_install | Inserisce una skill nel tuo AI OS, in modo che ogni agente che legge la cartella possa usarla. Si rifiuta di sostituire una skill con lo stesso nome a meno che tu non lo specifichi. | Your machine | Adds |
| docs_search | Risponde a una domanda su AI OS basandosi sulle guide qui pubblicate, piuttosto che su ciò che il modello ricorda a metà. | Either | Reads |
| docs_get | Legge una guida per intero, per quando un estratto non è sufficiente per agire. | Either | Reads |
| whoami | Indica quale account stai utilizzando, cosa puoi usare e quanto del tuo credito giornaliero è rimasto. Chiedi questo per primo quando uno strumento si rifiuta di funzionare. | Either | Reads |
| upgrade_info | Indica cosa include ogni livello e cosa aggiungerebbe per te quello successivo. | Either | Reads |
Il luogo in cui uno strumento viene eseguito dipende dal server a cui sei connesso, non dall'applicazione che utilizzi. Il server locale gira sulla tua macchina e può vedere la tua cartella, quindi include tutti i 16 strumenti. Il server ospitato gira sui nostri server e non ha una copia della tua cartella, quindi include gli 8 strumenti che non ne hanno bisogno.
È importante essere precisi su questo, perché è facile confondersi. Un agente nel cloud non è isolato dai tuoi file. Claude Cowork accede alle cartelle che gli alleghi e scrive al loro interno con i propri strumenti, quindi gli 8 strumenti ospitati sono davvero utili in quel contesto. Ciò che un agente cloud non può fare è avviare un server sulla tua macchina.
Nulla di ciò che è contrassegnato come "sulla tua macchina" è soggetto a misurazione, e nulla dei tuoi file viene inviato altrove. Questi strumenti funzionano anche senza accesso e offline, motivo per cui l'audit non costa nulla e non lo farà mai.
AI OS è disponibile in 3 livelli: AI OS Starter, AI OS Pro e AI OS Max. Ogni strumento elencato qui è disponibile su AI OS Starter oggi stesso. Un livello a pagamento aggiunge la profondità della risposta piuttosto che un elenco più lungo di strumenti.
MCP o la CLI
Entrambi provengono dalla stessa installazione ed entrambi leggono un unico elenco di strumenti, quindi nessuno dei due può avere uno strumento che manca all'altro. Questo è testato piuttosto che intenzionale: lo stesso audit eseguito su entrambi restituisce una risposta identica byte per byte. Ciò che cambia è quando lo paghi e chi digita.
Cosa ti costa ciascuno
Gli stessi 16 strumenti in entrambi i casi. Differiscono nel momento in cui li paghi.
| Server MCP | CLI | |
|---|---|---|
| Loaded every turn | 3.315 token | 97 token |
| Loaded when your AI OS comes up | Niente di più | 1.595 in più, una volta |
| Tools | 16 | 16 |
| With AIOS_READ_ONLY=1 | 2.364 token, 12 strumenti | Gli stessi 12 |
| Works on the web and on your phone | Sì, tramite il server ospitato, con 8 strumenti | No. Non c'è una riga di comando lì |
| Works with no AI open at all | No. MCP è il modo in cui un agente raggiunge uno strumento | Sì. Questa è l'unica interfaccia che lo fa |
| You start it by | Chiedendo qualcosa con parole tue | Digitando un comando |
Un server MCP invia il suo intero elenco di strumenti al modello ad ogni turno, che il tuo AI OS si attivi o meno. Questo è il prezzo per essere connessi, prima ancora di chiedere qualcosa. La CLI non costa nulla finché non viene richiamata: ciò che rimane nella conversazione è 1 riga che la descrive, e il resto arriva solo quando il tuo agente la richiede.
Su 20 turni in cui il tuo AI OS si attiva una volta, si tratta di 66.300 token contro 3.535. Quando l'intera conversazione è il tuo AI OS, il divario si riduce e il server offre un'esperienza migliore, perché chiedi in linguaggio naturale invece di ricordare i comandi.
La maggior parte dei 3.315 token non è qualcosa che si possa semplicemente eliminare. È il protocollo che scrive 16 strumenti come JSON Schema, e qualsiasi server con così tanti strumenti paga all'incirca lo stesso. Spegnilo nei giorni in cui non lo usi, e ogni client ha un modo per farlo.
Il numero rimane invariato man mano che il catalogo cresce, perché una "skill" viene recuperata quando il tuo agente ne chiede una, piuttosto che spedita quando si connette. Un server con 1 strumento per "skill" passerebbe 50.000 token in un anno, e non ci sarebbe modo di tornare indietro.
Ogni numero qui proviene da un vero "handshake" con questa build, contato con un "tokeniser" piuttosto che stimato dalla lunghezza del testo.
Come si usa ciascuno
| Cosa stai facendo | Con MCP | Con la CLI |
|---|---|---|
| Auditing a folder before you trust it | Chiedi al tuo agente di controllare il tuo AI OS. Ti legge il rapporto e si offre di risolvere la prima cosa che ha trovato. | Esegui aios-cli os-audit e leggi il rapporto tu stesso. Questo è quello che vuoi quando stai controllando diverse cartelle, o controllandone una prima che un agente l'abbia mai vista. |
| Fixing a voice file that is wrong | Il tuo agente recupera il "blueprint" vocale, ti intervista e scrive il file, tutto all'interno della conversazione. | Recuperi il "blueprint" e scrivi il file tu stesso, oppure chiedi a un agente che può eseguire un comando di farlo per te. |
| Installing a skill | Dici cosa vuoi che faccia il tuo AI OS, e il tuo agente cerca nel catalogo e lo installa. | Esegui aios-cli skills-search, poi aios-cli skills-install. |
| Setting up a second AI OS | Apri una conversazione in quella cartella e chiedi. | Esegui aios-cli os-init e prosegui. Più veloce quando ne stai facendo diversi. |
| Proving they really are the same thing | L'elenco degli strumenti che il tuo client riceve. | aios-cli schema os-audit stampa lo schema esatto che viene inviato a un client MCP, così puoi confrontarli tu stesso. |
Usa MCP come predefinito. È quello che ti permette di chiedere qualcosa con parole tue e di vederlo realizzato, che è il motivo per cui si ha un AI OS.
Ricorri alla CLI quando non c'è una conversazione da fare. Stai configurando diverse cartelle, o vuoi controllarne una prima che un agente l'abbia vista, o preferisci non portare l'elenco degli strumenti in ogni conversazione.
La maggior parte delle persone finisce per usare entrambi, ed entrambi provengono dalla stessa installazione.
Cosa rileva l'audit
Inizia da qui, a prescindere da qualsiasi altra cosa tu faccia. Questi sono i problemi che non puoi vedere da un elenco di file, ed è il motivo per cui esiste l'audit.
Una credenziale in un file di contesto
Incollato una volta e letto da ogni agente da allora. Viene segnalato redatto, mai per intero.
Segnaposto che nessuno ha compilato
Il tuo agente ha letto [Your name] come un fatto su di te per mesi.
File che esistono e non dicono nulla
Un file vocale vuoto è peggiore di uno mancante, perché sembra gestito.
Contesto troppo lungo per essere mantenuto
Nominati con il conteggio delle parole, così sai quale file tagliare e all'incirca di quanto.
Riferimenti a file che non esistono più
Il tuo agente li segue, non trova nulla e prosegue senza dirtelo.
Qualsiasi cosa obsoleta
Classificato in base a quanto è portante, non solo in base a quanto è vecchio.
Cosa farà e cosa non farà
Stai puntando un agente sulla cartella che descrive la tua attività, quindi vale la pena leggerlo prima di connettere qualsiasi cosa.
- I tuoi file di contesto non lasciano mai la tua macchina. L'audit li legge dove si trovano e non ne invia nessuno da nessuna parte. Solo il set di regole viaggia, e viaggia verso di te.
- Le scritture sono attive per impostazione predefinita. Un server la cui ogni scrittura necessita di un flag ti insegna a lasciare quel flag sempre attivo, il che sembra protezione ma non lo è.
- Tutto ciò che potrebbe sostituire un lavoro che non puoi recuperare viene rifiutato finché non lo confermi. Questo include
os_updatee unacontext_writesu un file che ha già del contenuto. - Imposta
AIOS_READ_ONLY=1e i 4 strumenti che scrivono non verranno mai offerti. Usalo quando punti un agente di cui non ti fidi completamente sulla tua cartella. - Imposta
AIOS_AUDIT_LOGsu un file e ogni tentativo di scrittura viene registrato, sia quelli rifiutati che quelli eseguiti. - Una credenziale trovata in un file di contesto viene segnalata in forma redatta, mai per intero, in modo che il ritrovamento non diventi una seconda copia della fuga di dati.
Livelli
AI OS è disponibile in 3 livelli: AI OS Starter, AI OS Pro e AI OS Max. Il livello è associato al tuo account piuttosto che a qualsiasi cosa tu abbia installato, quindi un aggiornamento modifica ciò che il tuo agente può fare alla sua prossima richiesta, senza bisogno di riconnettere nulla.
Tutti gli strumenti presenti in questa pagina sono disponibili su AI OS Starter. Ciò che un livello a pagamento aggiunge è profondità piuttosto che un elenco più lungo: il set completo di regole di audit, i blueprint corrispondenti al tipo di attività che svolgi effettivamente e un'indennità giornaliera più elevata per gli strumenti che raggiungono i nostri server.
Le indennità non sono ancora pubblicate qui, perché il sistema di gating non è ancora stato implementato. Ogni strumento viene fornito oggi come AI OS Starter. Questa pagina riporterà i numeri il giorno in cui saranno effettivi, piuttosto che una tabella di cifre non applicate.
Limiti
Gli strumenti locali non sono mai a consumo. Leggono e scrivono nella tua cartella, non raggiungono mai i nostri server e un limite su di essi costerebbe a te qualcosa senza farci risparmiare nulla.
Gli strumenti ospitati contano ai fini di un'indennità giornaliera sul tuo account. Ognuno ha un peso, quindi uno strumento costoso non può essere eseguito 500 volte all'interno di un limite dimensionato per quelli economici.
Quando esaurisci il limite, il rifiuto indica l'ora in cui si resetta anziché fallire silenziosamente. Chiedi al tuo agente whoami in qualsiasi momento e ti dirà cosa rimane.
Impostazioni
Nessuna di queste impostazioni è obbligatoria. Esistono per i casi in cui si desidera qualcosa di diverso dall'impostazione predefinita.
| Impostazione | Descrizione |
|---|---|
| AIOS_API_KEY | Una chiave per consentire a una macchina di accedere senza browser. Normalmente non si imposta mai. aios-cli login gestisce tutto e la chiave non è mai visibile. |
| AIOS_SESSION_PATH | Dove viene memorizzato l'accesso. L'impostazione predefinita è ~/.aios/session.json. |
| AIOS_OS_PATH | Specifica la cartella del tuo AI OS. L'impostazione predefinita è la posizione attuale, risalendo fino alla cartella CLAUDE.md, AGENTS.md o context più vicina, in modo simile a come git trova la sua root. |
| AIOS_READ_ONLY | Impostalo a 1 e nessuno strumento di scrittura sarà offerto. 12 strumenti invece di 16. |
| AIOS_AUDIT_LOG | Un file a cui aggiungere ogni tentativo di scrittura, sia consentito che rifiutato. |
| AIOS_API_URL | Punta a un indirizzo diverso da api.aios.guide. Per scopi di test. |
| AIOS_REQUEST_TIMEOUT_MS | Quanto tempo attendere una risposta prima di rinunciare. L'impostazione predefinita è 30000. |
Cosa significano i numeri
Un comando termina con uno di questi. Il tuo agente li legge così non devi farlo tu.
| Codice | Significato | Cosa è successo |
|---|---|---|
| 0 | Fatto | Ha funzionato. |
| 2 | Utilizzo | Il comando era sbagliato, mancava un argomento, oppure una scrittura è stata rifiutata perché non l'avevi confermata. |
| 3 | Non trovato | La skill, il blueprint o la guida che hai richiesto non esiste. |
| 4 | Accesso | Non hai effettuato l'accesso, oppure l'accesso non è più valido. |
| 5 | Server | Qualcosa è andato storto da parte nostra, oppure la rete ha avuto un problema. |
| 7 | Quota | Hai esaurito la quota giornaliera per gli strumenti ospitati. Il messaggio indica quando si resetta. |
| 10 | Non configurato | Niente è ancora configurato. Esegui aios-cli login. |
Hai ancora domande?
AI OS si connette tramite MCP, il Model Context Protocol. MCP è uno standard aperto che consente a un agente AI di accedere a strumenti esterni a sé stesso.
Aggiungi il server una sola volta. Dopodiché, il tuo agente può controllare il tuo AI OS, leggere e scrivere i tuoi file di contesto, recuperare la guida di scrittura per un file prima di scriverlo e cercare nel catalogo delle competenze, tutto all'interno di una singola conversazione.
MCP è un modo standard per un agente AI di utilizzare strumenti che non sono integrati in esso. Pensalo come un plugin che funziona ovunque invece che una volta per app.
Configuri AI OS una sola volta. La stessa connessione funziona poi in Claude, ChatGPT, Cursor, Codex e ogni altro agente su questa pagina.
La CLI è composta dagli stessi 16 strumenti dei comandi shell. Entrambe le interfacce leggono un unico elenco di strumenti, quindi nessuna delle due può avere uno strumento che manca all'altra.
Ci parli in entrambi i modi. Con MCP il tuo agente chiama lo strumento stesso. Con la CLI digiti `aios-cli os-audit`, oppure chiedi a un agente in grado di eseguire una shell di digitarlo per te.
La CLI aggiunge una cosa che MCP non può fare. Funziona senza alcun agente, quindi puoi inserirla in uno script, in CI, o inviare il suo JSON a jq. La maggior parte delle persone usa entrambi, ed entrambi provengono dalla stessa installazione.
Funziona ogni agente che parla MCP, il che copre gli 11 su questa pagina e qualsiasi altra cosa che accetti un URL del server. Ciò che cambia è dove l'agente viene eseguito.
- 8 agenti vengono eseguiti sulla tua macchina. Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, OpenClaw e Hermes ottengono tutti 16 strumenti, perché possono leggere e scrivere la tua cartella. Tutti e 8 possono anche eseguire la CLI.
- 3 agenti vengono eseguiti nel cloud. Claude Cowork, ChatGPT e Grok Bot si connettono tramite internet, quindi partono con gli 8 strumenti che non necessitano di un filesystem. Cowork può comunque raggiungere i tuoi file tramite l'app Claude Desktop, e Grok Bot può eseguire comandi sulla tua macchina una volta che lo consenti nelle sue impostazioni.
Controlla il tuo AI OS e poi ti aiuta a risolvere ciò che trova. Ogni altro strumento esiste per supportare questo.
- L'audit valuta la tua cartella e restituisce cosa correggere, dal peggiore al primo. Ogni risultato indica cosa fare dopo.
- Gli strumenti di contesto leggono e scrivono chi sei, come suoni e cosa vendi.
- I blueprint danno al tuo agente il metodo e un modello per ogni file, in modo che scriva a modo tuo invece che a modo suo.
- Gli strumenti delle competenze cercano nel catalogo e installano una competenza nel tuo OS.
- Lo strumento delle guide risponde alle domande basandosi su ciò che è pubblicato qui piuttosto che sulla memoria.
- Gli strumenti dell'account riportano il tuo livello, la tua quota e cosa aggiunge il livello successivo.
L'audit rileva i problemi che non puoi vedere da un elenco di file. Questa è la ragione della sua esistenza.
- Trova credenziali incollate in un file di contesto e lette da ogni agente da allora. Le segnala oscurate, mai per intero.
- Trova segnaposto di modelli che nessuno ha compilato. Il tuo agente li ha letti come fatti.
- Trova file che esistono e non dicono nulla. Un file vocale vuoto è peggio di uno mancante, perché sembra gestito.
- Trova contesto così lungo che la fine viene tagliata dalla finestra.
- Trova riferimenti che puntano a file che non ci sono.
No. Incolli l'URL e accedi, oppure esegui `aios-cli login` e completi nel browser che si apre. In entrambi i casi non vedrai mai una chiave.
Ogni strumento locale funziona senza accesso, incluso l'audit. L'accesso aggiunge il catalogo, i blueprint e le guide.
Grok è quello da controllare prima di iniziare. xAI documenta i connettori MCP personalizzati su grok.com/connectors e afferma che completi qualsiasi accesso richiesto dal server lì. La documentazione di Grok Bot non copre ancora l'aggiunta di un server MCP personalizzato.
Il server AI OS MCP e la CLI sono concessi in licenza sotto la Elastic License 2.0. Puoi leggere il codice sorgente, modificarlo e usarlo nella tua attività su quante macchine e progetti desideri.
Ci sono 2 cose che non puoi fare. Non puoi offrirlo ad altre persone come servizio ospitato o gestito, e non puoi spostare, modificare o aggirare i controlli di livello.
Questo lo rende disponibile come sorgente piuttosto che open source, il che è una vera differenza e vale la pena dirlo chiaramente. L'AI OS Starter Kit è un repository separato con la sua licenza.
No. L'audit legge i tuoi file sulla tua macchina e non ne invia nessuno da nessuna parte. Viene scaricato solo il set di regole, e il tuo contenuto non viaggia mai nell'altra direzione.
Questa è una proprietà del codice piuttosto che una promessa su una pagina. Nulla nella parte che legge i tuoi file è autorizzato a effettuare una richiesta di rete, e un test nel repository lo impone.
Tutti i 16 strumenti costano circa 3.659 token. Questo dato è misurato da una connessione reale, non stimato, e il README ti fornisce il comando per verificarlo tu stesso.
Il numero rimane invariato man mano che il catalogo cresce. Le competenze vengono recuperate quando il tuo agente ne richiede una, piuttosto che spedite al momento della connessione. Un server con 1 strumento per competenza supererebbe i 50.000 token entro un anno.
Niente per iniziare, e non hai bisogno di un account. AI OS Starter include ogni strumento locale senza limiti, perché questi strumenti non toccano mai i nostri server.
Gli strumenti ospitati hanno una quota giornaliera. AI OS Pro e AI OS Max aumentano questa quota, aggiungono le regole di audit più complete e aggiungono blueprint abbinati alla tua attività.
Sì. Usalo nella tua attività come preferisci, su quante macchine e progetti desideri. È pubblicato su npm e funziona in Docker, quindi si adatta ovunque tu già lavori.
Imposta `AIOS_READ_ONLY=1` per rimuovere ogni scrittura dall'elenco degli strumenti quando punti un agente di cui non ti fidi completamente alla tua cartella. Imposta `AIOS_AUDIT_LOG` per registrare ogni tentativo di scrittura, quelli rifiutati così come quelli eseguiti.
C'è anche un'API, quindi un agente non è mai l'unico modo per entrare.