AI OS CLI för Claude Codeoch alla AI-agenter
AI OS CLI ansluter dig till samma plattform direkt från kommandoraden. Det är samma 16 verktyg, så du eller din agent kan nå din mapp, katalogen, ritningarna och guiderna utan att öppna en chatt.
AI OS CLI är samma 16 verktyg som MCP-servern, men körs som kommandon istället för via en chatt.
Det kan låta som ett steg bakåt, och de flesta dagar är det inte det man väljer. Men det är den enda ytan som fungerar helt utan AI öppen, vilket är viktigt när du sätter upp flera mappar eller kontrollerar en innan en agent ser den.
Tänk på det som samma verktygslåda med ett annat handtag. Den här sidan visar dig när respektive handtag är det rätta.
- Vad AI OS CLI är och hur det förhåller sig till MCP-servern
- Vad du kan köra med det från kommandoraden
- Varje verktyg och vad det påverkar
- När du ska använda CLI och när du ska använda MCP
- Vad det kommer att göra och inte göra med dina filer
Låt oss börja med vad det faktiskt är.
Vad är AI OS CLI
AI OS CLI består av samma 16 verktyg som kommandon. Du installerar det en gång, och sedan kan antingen du eller din agent köra dem.
Det är den enda ytan som fungerar helt utan AI öppen, vilket är precis vad du vill när du sätter upp flera mappar, eller kontrollerar en innan en agent ser den.
Det är samma programvara som MCP-servern, i samma paket, och läser samma lista över verktyg. Att installera den ena ger dig båda.
Vad du kan fråga om
När den väl är ansluten pratar du med din agent som vanligt. Var och en av dessa kör ett verktyg från listan längre ner.
“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
Hela ditt AI OS, från kommandoraden
16 kommandon, grupperade efter vad de berör. 3 av dem täcker hela färdighetskatalogen, snarare än 1 kommando per färdighet, vilket är det som gör det hanterbart när katalogen växer.
Granskning
Granskar din mapp och berättar vad du ska åtgärda, med det värsta först. Varje fynd anger vad du ska göra härnäst.
Kontext
Läser och skriver filerna som innehåller information om vem du är, hur du låter och vad du säljer.
Ritningar
Metoden och en mall för varje fil, så det som skrivs följer din metod.
Färdigheter
Söker i katalogen och installerar en i ditt AI OS.
Guider
Svaren kommer från guiderna som publiceras här, inte från minnet.
Konto
Din nivå, din tillåtna användning och vad nästa nivå lägger till.
Alla kommandon, och vad de är till för
Alla 16. Kommandot är verktygsnamnet med bindestreck istället för understreck, så `os_audit` är `aios-cli os-audit`. Lägg till --help till något av dem för att se vad det kräver.
| Verktyg | Vad det är till för | Var det körs | Dina filer |
|---|---|---|---|
| os_audit | Berättar vad som är fel med ditt AI OS och vad du ska åtgärda först. Kör detta före något annat, och innan du tar någons råd om din installation. | Din maskin | Läser |
| os_init | Startar ett nytt AI OS i en mapp, så din agent har någonstans att lägga det den lär sig om dig. Den skriver avsiktligt tomma mallar och rör aldrig en fil som redan finns där. | Din maskin | Lägger till |
| os_validate | Bekräftar att dina filer faktiskt kan läsas av en agent. Front matter som öppnar och aldrig stänger gör en fil osynlig snarare än trasig, så inget varnar dig. | Din maskin | Läser |
| os_update | Uppdaterar ditt AI OS till den aktuella versionen och lämnar allt du själv har skrivit orört. Den jämför med hash, så dina egna ändringar rapporteras snarare än skrivs över. | Din maskin | Kan ersätta |
| context_list | Visar formen på ditt AI OS i ett ögonkast: vilka kontextfiler som finns, hur mycket som verkligen finns i varje, och när den senast ändrades. | Din maskin | Läser |
| context_read | Öppnar en fil i sin helhet, så en omskrivning bygger på vad du redan sagt istället för att ersätta det med en gissning. | Din maskin | Läser |
| context_write | Sparar det din agent lärt sig om dig i filen som innehåller det. En ny fil skrivs omedelbart. Att ersätta en som redan har innehåll frågar dig först. | Din maskin | Kan ersätta |
| blueprint_list | Visar varje skrivguide och mall på plattformen, så din agent vet vilken hjälp som finns innan den börjar skriva något. | Båda | Läser |
| blueprint_get | Ger din agent metoden för en fil, med en mall och arbetade exempel. Det är detta som får den att skriva på ditt sätt istället för att falla tillbaka på sina egna standardinställningar. | Båda | Läser |
| skills_search | Hittar en färdig färdighet för något du vill att ditt AI OS ska göra, så du inte beskriver det från grunden varje gång. | Båda | Läser |
| skills_get | Visar vad en färdighet faktiskt tillför, innan den ens kommer nära din mapp. | Båda | Läser |
| skills_install | Lägger en färdighet i ditt AI OS, så varje agent som läser mappen kan använda den. Den vägrar att ersätta en färdighet med samma namn om du inte säger till. | Din maskin | Lägger till |
| docs_search | Svarar på en fråga om AI OS från de guider som publiceras här, snarare än från vad modellen halvt minns. | Båda | Läser |
| docs_get | Läser en guide i sin helhet, för när ett utdrag inte räcker för att agera på. | Båda | Läser |
| whoami | Visar vilket konto du använder, vad du kan använda och hur mycket av dagens tillåtna mängd som återstår. Fråga efter detta först när ett verktyg vägrar. | Båda | Läser |
| upgrade_info | Berättar vad varje nivå inkluderar och vad nästa nivå skulle lägga till för dig. | Båda | Läser |
Var ett verktyg körs handlar om vilken server du är ansluten till, inte vilken app du använder. Den lokala servern körs på din egen maskin och kan se din mapp, så den hanterar alla 16. Den hostade servern körs på vår och har ingen kopia av din mapp, så den hanterar de 8 som inte behöver en.
Det är viktigt att vara noggrann med detta, eftersom det är lätt att missförstå. En agent i molnet är inte avskuren från dina filer. Claude Cowork når de mappar du kopplar till den och skriver i dem med sina egna verktyg, så de hostade 8 är verkligen användbara där. Vad en molnagent inte kan göra är att starta en server på din maskin.
Inget som är märkt din maskin är avgiftsbelagt, och inget om dina filer skickas någonstans. Dessa verktyg fungerar utloggade och offline, vilket är anledningen till att granskningen inte kostar något och aldrig kommer att göra det.
AI OS finns i 3 nivåer: AI OS Starter, AI OS Pro och AI OS Max. Alla verktyg som listas här är tillgängliga på AI OS Starter idag. Vad en betald nivå lägger till är djupet i svaret snarare än en längre lista med verktyg.
MCP eller CLI
Båda kommer från samma installation och båda läser en lista med verktyg, så ingen kan ha ett verktyg som den andra saknar. Det är testat snarare än avsett: samma granskning som körs genom båda returnerar ett byte för byte identiskt svar. Det som ändras är när du betalar för det, och vem som skriver.
Vad varje kostar dig
Samma 16 verktyg oavsett. De skiljer sig åt i när du betalar för dem.
| MCP-server | CLI | |
|---|---|---|
| Loaded every turn | 3 315 tokens | 97 tokens |
| Loaded when your AI OS comes up | Inget mer | 1 595 till, en gång |
| Tools | 16 | 16 |
| With AIOS_READ_ONLY=1 | 2 364 tokens, 12 verktyg | Samma 12 |
| Works on the web and on your phone | Ja, via den hostade servern, med 8 verktyg | Nej. Det finns ingen kommandorad där |
| Works with no AI open at all | Nej. MCP är hur en agent når ett verktyg | Ja. Detta är den enda ytan som gör det |
| You start it by | Ber om något med dina egna ord | Skriver ett kommando |
En MCP-server skickar hela sin verktygslista till modellen vid varje tur, oavsett om ditt AI OS dyker upp eller inte. Det är priset för att vara ansluten överhuvudtaget, innan du ber om något. CLI kostar inget förrän det anropas: det som finns i konversationen är 1 rad som beskriver det, och resten anländer först när din agent använder det.
Över 20 turer där ditt AI OS dyker upp en gång, blir det 66 300 tokens mot 3 535. När hela konversationen är ditt AI OS, minskar skillnaden och servern ger en bättre upplevelse, eftersom du frågar på vanligt språk istället för att komma ihåg kommandon.
Det mesta av de 3 315 är inget någon kan skriva bort. Det är protokollet som skriver ut 16 verktyg som JSON Schema, och varje server med så här många verktyg betalar ungefär detsamma. Stäng av det de dagar du inte använder det, och varje klient har ett sätt att göra det.
Antalet förblir konstant när katalogen växer, eftersom en färdighet hämtas när din agent ber om en snarare än skickas när den ansluter. En server med 1 verktyg per färdighet skulle passera 50 000 tokens inom ett år, och det skulle inte finnas någon återvändo från det.
Varje siffra här kom från en verklig handskakning mot denna version, räknad med en tokeniserare snarare än uppskattad från textens längd.
Hur varje är att använda
| Vad du gör | Med MCP | Med CLI |
|---|---|---|
| Auditing a folder before you trust it | Du ber din agent att granska ditt AI OS. Den läser upp rapporten för dig och erbjuder sig att åtgärda det första den hittade. | Du kör aios-cli os-audit och läser rapporten själv. Detta är den du vill ha när du kontrollerar flera mappar, eller kontrollerar en innan en agent någonsin har sett den. |
| Fixing a voice file that is wrong | Din agent hämtar röstritningen, intervjuar dig och skriver filen, allt inom konversationen. | Du hämtar ritningen och skriver filen själv, eller så ber du en agent som kan köra ett kommando att göra det åt dig. |
| Installing a skill | Du säger vad du vill att ditt AI OS ska göra, och din agent söker i katalogen och installerar det. | Du kör aios-cli skills-search, sedan aios-cli skills-install. |
| Setting up a second AI OS | Du öppnar en konversation i den mappen och frågar. | Du kör aios-cli os-init och går vidare. Snabbare när du gör flera. |
| Proving they really are the same thing | Verktygslistan din klient tar emot. | aios-cli schema os-audit skriver ut det exakta schemat som en MCP-klient skickas, så du kan jämföra dem själv. |
Använd MCP som standard. Det är den som låter dig be om något med dina egna ord och få det gjort, vilket är hela poängen med att ha ett AI OS överhuvudtaget.
Använd CLI när det inte finns någon konversation att ha. Du kanske sätter upp flera mappar, eller vill kontrollera en innan en agent har sett den, eller så vill du hellre slippa ha med verktygslistan i varje konversation.
De flesta använder båda, och båda kommer från samma installation.
Vad granskningen fångar upp
Börja här, oavsett vad du gör i övrigt. Det här är problem du inte kan se från en fillista, vilket är anledningen till att granskningen finns.
En uppgift i en kontextfil
Inklistrad en gång och läst av varje agent sedan dess. Den rapporteras censurerad, aldrig i sin helhet.
Platshållare som ingen fyllt i
Din agent har läst [Your name] som ett faktum om dig i månader.
Filer som finns men inte säger något
En tom röstfil är värre än en saknad, eftersom den ser hanterad ut.
För lång kontext för att överleva
Namngivna med ordantal, så du vet vilken fil du ska korta och ungefär hur mycket.
Referenser till filer som är borta
Din agent följer dem, hittar inget och fortsätter utan att berätta det för dig.
Allt inaktuellt
Rankad efter hur bärande den är, inte bara hur gammal den är.
Vad den gör och inte gör
Du riktar en agent mot mappen som beskriver din verksamhet, så detta är värt att läsa innan du ansluter något.
- Dina kontextfiler lämnar aldrig din maskin. Granskningen läser dem där de finns och skickar ingenstans. Endast regeluppsättningen färdas, och den färdas mot dig.
- Skrivningar är aktiverade som standard. En server vars varje skrivning kräver en flagga lär dig att lämna flaggan permanent aktiverad, vilket ser ut som skydd men inte är det.
- Allt som skulle kunna ersätta arbete du inte kan få tillbaka nekas tills du bekräftar det. Det gäller
os_updateoch encontext_writeöver en fil som redan innehåller data. - Ställ in
AIOS_READ_ONLY=1så erbjuds aldrig de 4 verktygen som skriver. Använd det när du riktar en agent du inte helt litar på mot din mapp. - Ställ in
AIOS_AUDIT_LOGtill en fil så loggas varje försök till skrivning, både de som nekades och de som kördes. - En uppgift som hittas i en kontextfil rapporteras maskerad, aldrig i sin helhet, så att fyndet inte blir en andra kopia av läckan.
Nivåer
AI OS finns i tre nivåer: AI OS Starter, AI OS Pro och AI OS Max. Nivån är kopplad till ditt konto snarare än till något du har installerat, så en uppgradering ändrar vad din agent kan göra vid nästa förfrågan, utan att du behöver återansluta något.
Alla verktyg på den här sidan är tillgängliga i AI OS Starter. En betald nivå lägger till djup snarare än en längre lista: den fullständiga uppsättningen granskningsregler, ritningar anpassade till den typ av verksamhet du faktiskt driver, och en högre daglig tilldelning för de verktyg som når våra servrar.
Tilldelningarna publiceras inte här ännu, eftersom begränsningen inte är byggd än. Alla verktyg levereras som AI OS Starter idag. Den här sidan får siffrorna den dagen de är verkliga, snarare än en tabell med siffror som inget upprätthåller.
Begränsningar
Lokala verktyg är aldrig avgiftsbelagda. De läser och skriver till din egen mapp, når aldrig våra servrar, och en begränsning på dem skulle kosta dig något samtidigt som det inte sparar oss något.
Värdbaserade verktyg räknas mot en daglig tilldelning på ditt konto. Var och en har en vikt, så ett dyrt verktyg kan inte köras 500 gånger inom en gräns anpassad för billiga.
När du har slut, anger vägran tiden för återställning istället för att misslyckas tyst. Fråga din agent om whoami när som helst så berättar den vad som återstår.
Inställningar
Inget av dessa är obligatoriskt. De finns till för de tillfällen du vill ha något annat än standardinställningen.
| Inställning | Vad den gör |
|---|---|
| AIOS_API_KEY | En nyckel som låter en maskin logga in utan webbläsare. Du ställer normalt aldrig in denna. aios-cli login hanterar det och du ser aldrig en nyckel. |
| AIOS_SESSION_PATH | Var inloggningen lagras. Standard är ~/.aios/session.json. |
| AIOS_OS_PATH | Vilken mapp är ditt AI OS. Standard är där du befinner dig, upp till närmaste CLAUDE.md, AGENTS.md eller kontextmapp, på samma sätt som git hittar sin rot. |
| AIOS_READ_ONLY | Sätt den till 1 så erbjuds inga skrivande verktyg alls. 12 verktyg istället för 16. |
| AIOS_AUDIT_LOG | En fil att lägga till varje skrivförsök i, både tillåtna och nekade. |
| AIOS_API_URL | Peka den någon annanstans än api.aios.guide. För testning. |
| AIOS_REQUEST_TIMEOUT_MS | Hur länge ska man vänta på ett svar innan man ger upp. Standard är 30000. |
Vad siffrorna betyder
Ett kommando avslutas med en av dessa. Din agent läser av dem så du slipper.
| Kod | Betyder | Vad hände |
|---|---|---|
| 0 | Klar | Det fungerade. |
| 2 | Användning | Kommandot var felaktigt, ett argument saknades, eller en skrivning nekades för att du inte hade bekräftat den. |
| 3 | Hittades ej | Färdigheten, ritningen eller guiden du efterfrågade finns inte. |
| 4 | Logga in | Du är inte inloggad, eller inloggningen är inte längre giltig. |
| 5 | Server | Något gick fel hos oss, eller i nätverket. |
| 7 | Tillåten mängd | Du har använt dagens tillåtna mängd för de hostade verktygen. Meddelandet anger när det återställs. |
| 10 | Ej konfigurerad | Inget är konfigurerat ännu. Kör aios-cli login. |
Har du några frågor?
AI OS ansluter via MCP, Model Context Protocol. MCP är en öppen standard som ger en AI-agent tillgång till externa verktyg.
Du lägger till servern en gång. Därefter kan din agent granska ditt AI OS, läsa och skriva dina kontextfiler, hämta skrivguiden för en fil innan den skriver den, och söka i färdighetskatalogen, allt inom en och samma konversation.
MCP är ett standardiserat sätt för en AI-agent att använda verktyg som inte är inbyggda. Tänk på det som ett plugin som fungerar överallt istället för bara i en app.
Du konfigurerar AI OS en gång. Samma anslutning körs sedan i Claude, ChatGPT, Cursor, Codex och alla andra agenter på den här sidan.
CLI:n består av samma 16 verktyg som shell-kommandon. Båda ytorna läser från en och samma lista med verktyg, så ingen kan ha ett verktyg som den andra saknar.
Du kommunicerar med den på båda sätten. Med MCP anropar din agent verktyget själv. Med CLI:n skriver du `aios-cli os-audit`, eller så ber du en agent som kan köra ett shell att skriva det åt dig.
CLI:n lägger till en sak som MCP inte kan göra. Den körs utan någon agent alls, så du kan lägga den i ett skript, i CI, eller skicka dess JSON till jq. De flesta använder båda, och båda kommer från samma installation.
Alla agenter som talar MCP fungerar, vilket inkluderar de 11 på den här sidan och allt annat som accepterar en server-URL. Det som skiljer sig är var agenten körs.
- 8 agenter körs på din maskin. Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, OpenClaw och Hermes får alla 16 verktyg, eftersom de kan läsa och skriva i din mapp. Alla 8 kan också köra CLI:n.
- 3 agenter körs i molnet. Claude Cowork, ChatGPT och Grok Bot ansluter via internet, så de använder de 8 verktyg som inte kräver ett filsystem. Cowork kan fortfarande nå dina filer via Claude Desktop-appen, och Grok Bot kan köra kommandon på din maskin när du tillåter det i dess inställningar.
Den granskar ditt AI OS och hjälper dig sedan att åtgärda det den hittar. Alla andra verktyg finns för att stödja detta.
- Granskningen betygsätter din mapp och returnerar vad som behöver åtgärdas, värst först. Varje fynd anger vad som ska göras härnäst.
- Kontextverktygen läser och skriver vem du är, hur du låter och vad du säljer.
- Ritningarna ger din agent metoden och en mall för varje fil, så att den skriver på ditt sätt istället för sitt eget.
- Färdighetsverktygen söker i katalogen och installerar en färdighet i ditt OS.
- Guideverktyget svarar på frågor utifrån det som publiceras här snarare än från minnet.
- Kontoverktygen rapporterar din nivå, din tillåtna användning och vad nästa nivå lägger till.
Granskningen upptäcker problem som du inte kan se från en fillista. Det är anledningen till att den finns.
- Den hittar inloggningsuppgifter inklistrade i en kontextfil och lästa av varje agent sedan dess. Den rapporterar dem censurerade, aldrig i sin helhet.
- Den hittar mallplatshållare som ingen har fyllt i. Din agent har läst dessa som fakta.
- Den hittar filer som finns men som inte säger något. En tom röstfil är värre än en saknad, eftersom den ser ut att vara hanterad.
- Den hittar kontext som är så lång att slutet av den tappas från fönstret.
- Den hittar referenser som pekar på filer som inte finns.
Nej. Du klistrar in URL:en och loggar in, eller så kör du `aios-cli login` och slutför i webbläsaren som öppnas. Hur som helst ser du aldrig en nyckel.
Alla lokala verktyg fungerar utloggade, inklusive granskningen. Att logga in lägger till katalogen, ritningarna och guiderna.
Grok är den du ska kontrollera innan du börjar. xAI dokumenterar anpassade MCP-anslutningar på grok.com/connectors, och säger att du slutför den inloggning servern begär där. Grok Bots egen dokumentation täcker ännu inte hur man lägger till en anpassad MCP-server.
AI OS MCP-servern och CLI:n är licensierade under Elastic License 2.0. Du kan läsa källkoden, ändra den och använda den i din egen verksamhet på så många maskiner och projekt du vill.
Det finns 2 saker du inte kan göra. Du kan inte erbjuda den till andra som en hostad eller hanterad tjänst, och du kan inte flytta, ändra eller kringgå nivåkontrollerna.
Detta gör den källkodstillgänglig snarare än öppen källkod, vilket är en verklig skillnad och värt att säga rakt ut. AI OS Starter Kit är ett separat arkiv med en egen licens.
Nej. Granskningen läser dina filer på din maskin och skickar ingen av dem någonstans. Endast regeluppsättningen laddas ner, och ditt innehåll färdas aldrig åt andra hållet.
Detta är en egenskap hos koden snarare än ett löfte på en sida. Ingenting i den del som läser dina filer får göra en nätverksförfrågan, och ett test i arkivet säkerställer detta.
Alla 16 verktyg kostar cirka 3 659 tokens. Den siffran är uppmätt från en verklig anslutning, inte uppskattad, och README-filen ger dig kommandot för att kontrollera det själv.
Antalet förblir konstant när katalogen växer. Färdigheter hämtas när din agent begär en, snarare än att skickas vid anslutningstillfället. En server med 1 verktyg per färdighet skulle passera 50 000 tokens inom ett år.
Inget till att börja med, och du behöver inget konto. AI OS Starter inkluderar alla lokala verktyg utan begränsning, eftersom dessa verktyg aldrig rör våra servrar.
De hostade verktygen har en daglig tillåten användning. AI OS Pro och AI OS Max höjer den tillåtna användningen, lägger till de fylligare granskningsreglerna och lägger till ritningar anpassade till din verksamhet.
Ja. Använd den i din egen verksamhet hur du vill, på så många maskiner och projekt du vill. Den publiceras på npm och körs i Docker, så den passar in var du än redan arbetar.
Ställ in `AIOS_READ_ONLY=1` för att ta bort alla skrivningar från verktygslistan när du pekar en agent du inte helt litar på mot din mapp. Ställ in `AIOS_AUDIT_LOG` för att registrera varje försök till skrivning, både de som nekades och de som kördes.
Det finns också ett API, så en agent är aldrig den enda vägen in.