Manualen
AI
Omarchy inkluderer oppstartskommandoer for kodeagentene nedenfor, uten å velge en standard for deg. Kjør en kommando for å installere CLI-en ved første bruk, og logg deretter inn når du blir bedt om det. Hermes er unntaket: ingenting installeres for den ved første bruk, og hvis du velger den, installeres Hermes Desktop, slik Desktop apps nedenfor forklarer.
| Kommando | Agent |
|---|---|
claude |
Claude Code |
codex |
OpenAI Codex |
opencode |
OpenCode |
agy |
Google Antigravity CLI |
amp |
Amp |
commandcode |
Command Code |
copilot |
GitHub Copilot CLI |
crush |
Crush |
cursor-agent |
Cursor CLI |
devin |
Devin CLI fra Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuffs gratis, annonsestøttede kodeagent |
grok |
Grok Build fra xAI |
hermes |
Hermes, Nous Researchs agent |
kilo |
Kilo, en kodeagent basert på OpenCode |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMaxs kodeagent |
muse |
Muse Code, Metas kodeagent |
omp |
Oh My Pi |
ori |
Ori, OpenRouters harness |
pi |
Mario Zechners Pi |
qwen |
Qwen Code, Alibabas kodeagent |
ori skiller seg ut: den kjører de andre harnessene mot hele modellkatalogen til OpenRouter, så ori claude, ori codex eller ori opencode starter disse agentene på den modellen du peker dem mot, og ori code er Oris egen agent.
Installere og oppdatere agenter
Med unntak av Hermes bruker disse agentene mises late installasjon: første oppstart installerer CLI-en, og senere oppstarter gjenbruker den. mise sjekker også en installert agent for en ny versjon høyst én gang hver fjerde time, rett før den starter eller i bakgrunnen ved en shell-ledetekst. Hvis oppdateringen mislykkes eller du er frakoblet, kjører den installerte versjonen. omarchy update oppdaterer installerte agenter sammen med resten av Omarchy, og mup oppdaterer kun mise-administrerte verktøy.
En agents egen oppdaterer, som claude update, codex update eller en oppdateringsknapp i en app, oppdaterer ikke den mise-administrerte installasjonen. codex update mislykkes, og claude update kan rapportere suksess mens den installerer en separat kopi som mise ikke sporer. Hvis du heller vil bruke en agents egen installasjons- og oppdateringsfunksjon, legg den til i disable_tools; se Preinstalled CLI tools.
For å installere alle konfigurerte late verktøy før du trenger dem, kjør mise install --include-lazy. Dette inkluderer Omarchys andre standard CLI-verktøy i tillegg til agentene. Se Preinstalled CLI tools for hvordan du installerer ett enkelt verktøy eller bruker din egen installasjon.
grok installeres gjennom mises førsteparts grok-pakke, på samme måte som claude og codex. Kjør grok, eller velg den under Setup > Defaults > Agent. Hopp over curl | bash-installasjonen på x.ai. Den banen legger en ny kopi i ~/.grok/bin, setter den først på PATH og overskriver Omarchys wrapper.
dsh åpner sitt nettlesergrensesnitt på 127.0.0.1:3080, med oppstartsmappen som standard arbeidsområde. Nettlesergrensesnittet tar ingen startprompt, så omarchy agent prompt åpner det med prompten på utklippstavlen, klar til å limes inn. Omarchy starter det med DeepSeeks forhåndsinnstilling for tillatelser uten godkjenning. DeepSeek Harness laster opp øktlogger til DeepSeek når du bruker den offisielle modell-API-en; slå det av under Settings > General > Upload Session Log i nettlesergrensesnittet. Tilbakemeldinger du sender den, lastes også opp sammen med økten, med mindre du starter den med DSH_TELEMETRY_MODE=DISABLED.
Standardagenten
Velg standardagenten din med omarchy default agent <name> eller under Setup > Defaults > Agent i Omarchy-menyen (Super + Space). Hvis agenten ikke er installert ennå, installeres den først når du velger den. En fersk Omarchy inviterer deg til å ta dette valget med et engangsvarsel.
Hvis du velger Claude, forsøkes det også å sette opp nettleserutvidelsen dens for Chromium, Chrome, Brave, Brave Origin og Edge. Oppsettet av utvidelsen gjelder for alle brukere og kan be om systempassordet ditt; å avbryte eller en mislykket installasjon av utvidelsen velger og starter likevel Claude. Start nettleseren på nytt, aktiver utvidelsen hvis du blir bedt om det, og logg inn på Claude for å fullføre tilkoblingen. Kjør /chrome i Claude for å sjekke tilkoblingen. Firefox og Zen støtter ikke denne utvidelsen. Hvis Claude allerede var standarden din før dette oppsettet ble lagt til, velg den på nytt for å installere utvidelsen.
Når du har valgt, starter Super + Shift + Ctrl + A standardagenten i et eget terminalvindu (eller viser velgeren hvis du ikke har valgt ennå). Du kan også starte den rett i en oppgave med omarchy agent prompt "Review this project". Freebuff og DeepSeek Harness tar ingen startprompt, så de åpner i stedet med prompten på utklippstavlen, klar til å limes inn. Agenter startet på denne måten kjører uten å bli overvåket, i sine respektive modus som ikke stopper for å spørre, så vær klar for at de faktisk gjør ting! MiniMax Code har ingen slik modus for sine interaktive økter, så den ber om tillatelser som vanlig. Og siden agenter nekter å huske tillit til hjemmemappen din, starter oppstarter fra $HOME i ~/Work i stedet.
Det finnes også terminalsnarveier: a kjører standardagenten inne i gjeldende terminal, mens c, cx og cy starter OpenCode, Claude Code og Codex direkte (også i sine moduser for automatisk godkjenning). Temabytter synkroniseres også til agentene: Claude Code, Pi, OpenCode og Hermes (når Omarchy har installert den) følger alle med når du bytter Omarchy-tema.
Agentpanelet
Den øverste linjen har et agentikon. Før du har satt opp en agent, går panelet gjennom innlogging til Claude, Codex eller Grok, og den første blir standardagenten din. Etter det samler panelet alle abonnementer på én side: hver agent og konto med abonnementet sitt, en måler for hver av dens 5-timers økt- og ukesgrenser med tiden til den nullstilles (hold musepekeren over for nøyaktig prosent), eller den gjenværende forhåndsbetalte saldoen, under en linje som rullerer gjennom det du har brukt på tvers av alle, som tokens denne uken og din mest brukte modell. Under Make something tilbyr det startprompter for et nytt tema, en ny plugin eller en ny app som gir oppgaven til standardagenten din. Apper bygges slik Omarchys egne Hype, Monologue og Omacut er det, i C++ og Qt Quick, etter omarchy-app-agentferdigheten, og kompilatoren og Qt-delene de trenger, følger med installert. Claude Code, Codex, Grok, Kimi, Cursor og Grok Bot-kvoten dens, GitHub Copilot, Muse, Antigravity, Kimchi og Devin dekkes fra start med sine grenser, og Hermes, Mistral Vibe og Qwen Code viser sine økter og tokens når du har brukt dem. Leverandørabonnementer og -nøkler du bruker gjennom pi, omp eller opencode, vises også: OpenCode Zen og Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan og Synthetic med sine grenser; Fireworks, OpenRouter og DeepSeek med sine forhåndsbetalte saldoer; og modellene du kjører på din egen maskinvare under Local models. Hver agent telles én gang, under den som fakturerer den, uansett hvor mange harnesser du kjører den gjennom.
Venstreklikk på ikonet i linjen for panelet, høyreklikk for å starte standardagenten din. Bruksloggene bak det genereres på nytt hvert 15. minutt av omarchy agent usage-update, og panelet kan til og med slå sammen bruk fra de andre maskinene dine via en synkronisert mappe. Se README under $OMARCHY_PATH/shell/plugins/agents/ for alle innstillingene.
Flere abonnementer
Hvis du betaler for mer enn ett Claude-, Codex- eller Grok-abonnement - ett privat Max og ett jobb, for eksempel - kan Omarchy holde dem alle innlogget og flytte mellom dem. Legg til et abonnement med + i agentpanelet, som veileder deg gjennom det der, eller med omarchy agent account add claude Work (eller codex, eller grok). Det installerer CLI-en hvis den mangler. Den første kontoen for en leverandør logger inn gjennom den vanlige nettleseren din, akkurat der CLI-en alltid ser. Alle etter det logger inn gjennom et privat vindu, slik at kontoen nettleseren din allerede er logget inn på, ikke tas med ved en feil; logg der inn som kontoen du legger til, og lukk først alle private vinduer du allerede hadde åpne. Logg aldri ut av CLI-en for å gjøre dette: å logge ut trekker tilbake den lagrede innloggingen, og den kontoen måtte legges til på nytt.
For å kopiere abonnementsinnloggingene dine til en annen Omarchy-maskin over SSH, kjør omarchy agent account copy user@laptop. Avsenderen leverer en midlertidig mottaker når destinasjonen ikke har en installert, slik at eldre Omarchy-maskiner kan motta kontoer uten en oppdatering. Installerte mottakere har forrang. Dette kopierer alle Claude-, Codex- og Grok-abonnementer; legg til leverandørnavn for å velge dem, som i omarchy agent account copy laptop claude. Kontonavn og kommando-ID-er matcher kilden, inkludert kontoer som allerede finnes på destinasjonen. Urelaterte kontoer på destinasjonen får et numerisk suffiks hvis navnene deres kommer i konflikt, og innstillinger, ferdigheter, plugins og samtalehistorikk forblir lokale på hver maskin.
Eksisterende legitimasjon på destinasjonen beholdes. En kildekonto som allerede er logget inn der, får navnet sitt synkronisert uten å erstatte legitimasjonen; andre kontoer legges til ved siden av. For å erstatte lagret legitimasjon for matchende kontoer, bruk omarchy agent account copy --replace laptop claude etter å ha avsluttet øktene til den kontoen på destinasjonen. En fersk destinasjon får også kildens aktive konto og bytteinnstillinger; en etablert destinasjon beholder sine egne.
Legitimasjon reiser gjennom SSH og lagres i private filer på destinasjonen, så kopier kun til maskiner du stoler på. Dette er en engangskopiering, ikke løpende synkronisering. Codex-oppdateringstokens kan roteres av en annen maskin, slik at en kopiert innlogging trenger fornyelse; separate innlogginger forblir det mest pålitelige valget ved samtidig bruk på flere maskiner. Se Codexs veiledning for kontoautentisering.
Én konto per leverandør er aktiv, og hver ny økt starter som den: cx, cy, en ren claude, codex eller grok, alt som startes gjennom omarchy agent, og skript eller editorer som finner CLI-en på PATH. Bytt med omarchy agent account use work (og tilbake med omarchy agent account use main), eller i panelet ved å trykke på nummeret til en konto og deretter Enter (eller klikke på Bruk-knappen dens). Økter som allerede kjører, forblir på kontoen de startet med. Samtalehistorikk, innstillinger, ferdigheter og plugins deles på tvers av kontoer, så claude --continue i samme mappe fortsetter der du slapp på den nye kontoen.
Med mer enn én konto viser panelet grensene til hver konto side ved side, med den aktive markert. Som standard varsler Omarchy deg når den aktive kontoen passerer 95 % av en grense, og å klikke på varslet bytter til kontoen med mest ledig kapasitet. Hold musepekeren over linjen til en konto i panelet og klikk på Autoswitch som vises ved siden av Use (eller trykk m), eller kjør omarchy agent account mode auto, for å få den til å bytte på egen hånd i stedet; mens den er på, tar Autoswitch plassen til Use, og å klikke på den igjen går tilbake til varsling. Legg til et tall for å endre terskelen, som i omarchy agent account mode auto 90. Hvis hver konto er over terskelen, får du høre om det én gang, sammen med hvilken konto som frigjøres først. Mens en aktiv konto er innen 15 poeng av terskelen sin (80 % som standard), sjekkes grensene dens hvert tredje minutt i stedet for hvert 15.
omarchy agent account list viser hver konto og de siste grensene dens, omarchy agent account remove work glemmer én, og omarchy agent account rename primary Hey gir én et nytt navn (eller klikk på navnet til en konto i panelet). Disse kommandoene virker på kontoene til standardagenten din; for å nå den andre leverandøren, oppgi den først, som i omarchy agent account use codex side. Innloggingen du allerede hadde i ~/.claude eller ~/.codex, er Main-kontoen og forblir der den er. En konto som ikke har vært brukt i mer enn omtrent åtte timer, kan vise Sign-in required; klikk på den for å logge den kontoen inn igjen rett i panelet, eller start en økt i den, som frisker opp innloggingen på egen hånd. MCP-servere du hadde da en konto ble lagt til, blir med til den, men de du legger til senere med claude mcp add, når kun kontoen du la dem til i. Claude Desktop og verktøy som er konfigurert med en absolutt bane til en CLI-binærfil, følger ikke byttet. En eksplisitt CLAUDE_CONFIG_DIR, CODEX_HOME eller GROK_HOME har forrang over den valgte kontoen.
Krasjdiagnose
Omarchy overvåker systemd-coredump for prosesskrasj. Når noe segfaulter, får du et “Process crashed”-varsel - klikk på det, og krasjet gis til standardagenten din sammen med Omarchys diagnose-crash-ferdighet, som går gjennom etablering av fakta fra core dump-en med agenten og avgjør om krasjet er verdt å rapportere oppstrøms. Du kan også kjøre det manuelt mot en hvilken som helst PID fra coredumpctl list med omarchy agent crash <pid>.
Overvåkingen er på som standard. Slå den av under Trigger > Toggle > Crash Capture (eller med omarchy toggle crash-capture), og varslene stopper; omarchy agent crash <pid> virker fortsatt manuelt.
Krasj kan også dempes ett program om gangen, noe diagnoseverktøyet tilbyr deg til slutt. omarchy crash mute hyprland stopper varslene kun for det programmet, omarchy crash mute hyprland off bringer dem tilbake, og omarchy crash mute alene lister det du har dempet. Den tar like gjerne banen til binærfilen som navnet, så omarchy crash mute /usr/bin/hyprland gjør det samme. Sett et navn med mellomrom i anførselstegn, som i omarchy crash mute 'Some App'. Alt annet varsler fortsatt, og det dempede programmet krasjer fortsatt - dette skjuler påminnelsen, det fikser ingenting.
Skrivebordsapper
Install > AI-menyen har også noen grafiske AI-apper: ChatGPT-skrivebordsappen, Claude-skrivebordsappen (Anthropics Linux-beta, med fanene Chat, Cowork og Claude Code), Grok Bot for å chatte med xAIs modeller, Hermes Desktop, OpenClaw, Perplexity-skrivebordsappen og T3 Code. Grok Bot er skrivebords-chatteappen. Kodeagenten er grok-kommandoen.
Hermes Desktop er den du må kjenne til, fordi en maskin har én Hermes, og den er appens: Hermes installeres bare noen gang gjennom appen, og hermes-kommandoen standardagenten kjører, er appens. Å velge Hermes som standardagent installerer det samme som Install > AI-oppføringen gjør: pakken, og en Hermes-kjøretid under ~/.hermes satt opp av Hermes’ egen installasjonsprogram, som tar noen minutter første gang. Den kjøretiden er den ene Hermes som terminalens hermes-kommando, standardagenten og appen alle bruker, og den oppdaterer seg selv med hermes update i stedet for å vente på en Omarchy-utgivelse. Å installere den gir også Hermes Omarchy-temaet som et skall kalt omarchy, som hver Hermes-overflate følger når du bytter tema; velg et annet under Hermes’ Appearance-innstillinger eller med /skin hvis du helst vil at den ikke skal det, og Omarchy lar det valget være i fred. Å fjerne appen under Remove > AI lukker Hermes først, gateway inkludert, tar kjøretiden med seg, og beholder chattene, minnene og ferdighetene Hermes skrev for seg selv, med mindre du sier noe annet: den spør, med nei som standard, om disse dataene og tilkoblingsinnstillingene dine skal gå også.
OpenClaws skrivebordsopplevelse er dens Control UI, som åpner som en webapp støttet av dens egen lokale gateway. OpenClaw bor i ~/.openclaw og oppdaterer seg selv: bruk “Update Gateway”-knappen i Control UI eller kjør openclaw update, og gatewayen starter på nytt på den nye versjonen. Omarchy velger kun hvilken utgivelse en fersk installasjon starter fra. Å fjerne OpenClaw under Remove > AI tar gateway-tjenesten og appen med seg og spør deretter om ~/.openclaw skal gå også, siden den holder chattene og legitimasjonen din sammen med OpenClaw selv og plugin-kjøretidene den laster ned; standarden beholder den, og å installere OpenClaw igjen tar den opp igjen.
T3 Code kjører fra sin offisielle AppImage-utgivelse i ~/.local/share/t3code i stedet for fra en pakke, så den oppdaterer seg selv. Å installere den spør om du vil starte på Stable- eller Nightly-kanalen; bytt senere i T3 Codes innstillinger. Trådene og innstillingene dine bor i ~/.t3, og å fjerne T3 Code under Remove > AI tar dem med seg.
Lokale LLM-er
Omarchy anbefaler to måter å kjøre lokale LLM-modeller på: LM Studio og Ollama. LM Studio gir et GUI-grensesnitt for å finne åpen-vekt-modeller, installere dem og kjøre dem. Det er en flott måte å komme enkelt i gang på. Ollama tilbyr en CLI for å gjøre noe lignende. Men hvis du er ny med lokale modeller, ville jeg startet med LM Studio. Du kan installere begge under Install > AI i Omarchy-menyen.
Omarchy Skill
Agentferdigheter hjelper AI med å bruke spesifikke verktøy på en spesifikk måte, og Omarchy leveres med en standardferdighet for å tilpasse systemet. Som å justere Hyprland-konfigurasjonen din, justere linjen, eller til og med lage et nytt tema fra bunnen av. Den er symlinket inn i ferdighetsmappene for Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills og hver ~/.hermes/profiles/*/skills), og den generiske ~/.agents/skills-plasseringen, slik at de fleste harnesser tar den opp automatisk.
Men du bør behandle denne ferdigheten som eksperimentell. Ulike modeller vil bruke den med ulik effekt. Det er best å kjøre i planmodus først, slik at du får en idé om hva agenten vil endre. Og vær deretter klar til å rulle tilbake endringer eller til og med kjøre omarchy reinstall configs, hvis agenten gjør et rot av alt.