Gå til indholdet
Chapters
  1. Velkommen til Omarchy!
  2. Kom godt i gang
  3. Kommer du fra Mac eller Windows
  4. Navigation
  5. Topbjælken
  6. Temaer
  7. Genvejstaster
  8. Ensartet udklipsholder og historik
  9. Påmindelser
  10. Notifikationer
  11. Tekstudtræk & diktering
  12. Skærmbilleder og optagelse
  13. Til/fra-skift, inaktivitet og pauseskærmen
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Udviklingsværktøjer
  19. Shellværktøjer
  20. Shellfunktioner
  21. TUIs
  22. GUI'er
  23. Browsere
  24. Kommercielle apps/tjenester
  25. Webapps
  26. Gaming
  27. Udfyldning af PDF'er
  28. Windows VM
  29. Andre pakker
  30. Opdateringer
  31. Dotfiler
  32. Shell-plugins
  33. Skærme
  34. Tastatur, mus, trackpad
  35. Netværk
  36. Systemhvile
  37. Hardwaregodkendelse
  38. Skrifttyper
  39. Baggrunde
  40. Prompt
  41. Branding
  42. Almindelige justeringer
  43. Lav dit eget tema
  44. Mac-support
  45. Fejlfinding
  46. FAQ
  47. Systemsnapshots
  48. Sikkerhed
  49. Omarchy på...
  50. Installation med dual boot
  51. Uovervågede installationer

Håndbog

AI

Omarchy inkluderer launchere til nedenstående kodeagenter uden at vælge en standard for dig. Kør en kommando for at installere dens CLI ved første brug, og log derefter ind, når du bliver bedt om det. Hermes er undtagelsen: Der installeres intet for den ved første brug, og at vælge den installerer Hermes Desktop, som Skrivebordsapps 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, reklamefinansierede kodeagent
grok Grok Build fra xAI
hermes Hermes, Nous Researchs agent
kilo Kilo, en OpenCode-baseret kodeagent
kimi Kimi Code
kiro-cli Kiro CLI
mcode MiniMax Code, MiniMax’ kodeagent
muse Muse Code, Metas kodeagent
omp Oh My Pi
ori Ori, OpenRouters harness
pi Mario Zechner’s Pi
qwen Qwen Code, Alibabas kodeagent

ori skiller sig ud: Den kører de andre harnesser mod OpenRouters samlede modelkatalog, så ori claude, ori codex eller ori opencode starter disse agenter på den model, du peger dem på, og ori code er Oris egen agent.

Installation og opdatering af agenter

Bortset fra Hermes bruger disse agenter mises dovne installation: Første start installerer CLI’en, og senere starter genbruger den. mise tjekker også en installeret agent for en ny udgivelse højst én gang hver fjerde time, lige før den starter eller i baggrunden ved en shell-prompt. Hvis opdateringen mislykkes, eller du er offline, kører den installerede version. omarchy update opdaterer installerede agenter sammen med resten af Omarchy, og mup opdaterer kun mise-administrerede værktøjer.

En agents egen opdateringsfunktion, såsom claude update, codex update eller en opdateringsknap i en app, opdaterer ikke den mise-administrerede installation. codex update mislykkes, og claude update kan melde succes, mens den installerer en separat kopi, som mise ikke holder øje med. Hvis du hellere vil bruge en agents eget installations- og opdateringsprogram, skal du tilføje den til disable_tools; se Forudinstallerede CLI-værktøjer.

For at installere alle konfigurerede dovne værktøjer, før du får brug for dem, skal du køre mise install --include-lazy. Det omfatter Omarchys andre standard-CLI-værktøjer såvel som agenterne. Se Forudinstallerede CLI-værktøjer for at installere et enkelt værktøj eller bruge din egen installation.

grok installeres via mises førsteparts grok-pakke på samme måde som claude og codex. Kør grok, eller vælg den under Setup > Defaults > Agent. Spring curl | bash-installationsprogrammet på x.ai over. Den vej lægger en anden kopi i ~/.grok/bin, sætter den forrest på PATH og overskriver Omarchys wrapper.

dsh åbner sin browser-UI på 127.0.0.1:3080 med startmappen som standardarbejdsområde. Dens browser-UI tager ingen startprompt, så omarchy agent prompt åbner den med prompten på din udklipsholder, klar til at sætte ind. Omarchy starter den med DeepSeeks forudindstilling for tilladelser uden godkendelse. DeepSeek Harness uploader sessionslogge til DeepSeek, når du bruger dens officielle model-API; slå det fra under Settings > General > Upload Session Log i dens browser-UI. Feedback, du sender til den, uploades også sammen med sessionen, medmindre du starter den med DSH_TELEMETRY_MODE=DISABLED.

Standardagenten

Vælg din standardagent med omarchy default agent <name> eller under Setup > Defaults > Agent i Omarchy Menu (Super + Space). Hvis agenten ikke er installeret endnu, installerer valget af den den først. En frisk Omarchy vil invitere dig til at træffe dette valg med en engangsnotifikation.

At vælge Claude forsøger også at sætte dens browserudvidelse op til Chromium, Chrome, Brave, Brave Origin og Edge. Opsætningen af udvidelsen gælder for alle brugere og kan bede om din systemadgangskode; at annullere eller en mislykket installation af udvidelsen vælger og starter stadig Claude. Genstart din browser, aktivér udvidelsen, hvis du bliver bedt om det, og log ind på Claude for at færdiggøre forbindelsen til den. Kør /chrome i Claude for at tjekke forbindelsen. Firefox og Zen understøtter ikke denne udvidelse. Hvis Claude allerede var din standard, før denne opsætning blev tilføjet, skal du vælge den igen for at installere udvidelsen.

Når du har valgt, starter Super + Shift + Ctrl + A standardagenten i et dedikeret terminalvindue (eller viser vælgeren, hvis du ikke har valgt endnu). Du kan også starte den direkte på en opgave med omarchy agent prompt "Review this project". Freebuff og DeepSeek Harness tager ingen startprompt, så de åbner i stedet med prompten på din udklipsholder, klar til at sætte ind. Agenter, der startes på denne måde, kører uden opsyn i deres respektive tilstande, hvor de ikke stopper for at spørge, så vær klar på, at de rent faktisk gør ting! MiniMax Code har ingen sådan tilstand til sine interaktive sessioner, så den beder om tilladelser som sædvanlig. Og da agenter nægter at huske tillid til din hjemmemappe, starter starter fra $HOME i stedet i ~/Work.

Der er også terminalgenveje: a kører standardagenten indlejret i den aktuelle terminal, mens c, cx og cy starter OpenCode, Claude Code og Codex direkte (igen i deres automatisk godkendende tilstande). Temaændringer synkroniseres også til agenterne: Claude Code, Pi, OpenCode og Hermes (når Omarchy har installeret den) følger alle med, når du skifter Omarchy-temaet.

Agentpanelet

Den øverste bjælke har et agentikon. Før du har sat en agent op, fører dens panel dig gennem login på Claude, Codex eller Grok, og den første bliver din standardagent. Derefter samler panelet alle abonnementer på én side: hver agent og konto med dens abonnement, en måler for hver af dens 5-timers sessions- og ugentlige grænser med tiden, til den nulstilles (hold musen over for den nøjagtige procentdel), eller den resterende forudbetalte saldo, under en linje, der roterer gennem det, du har brugt på tværs af dem alle, såsom tokens i denne uge og din mest brugte model. Under Make something tilbyder det startprompter til et nyt tema, plugin eller en ny app, som overlader opgaven til din standardagent. Apps bygges på samme måde som Omarchys egne Hype, Monologue og Omacut, i C++ og Qt Quick, efter omarchy-app-agentfærdigheden, og compileren og de Qt-dele, de har brug for, følger med installeret. Claude Code, Codex, Grok, Kimi, Cursor og dens Grok Bot-kvote, GitHub Copilot, Muse, Antigravity, Kimchi og Devin er dækket fra start med deres grænser, og Hermes, Mistral Vibe og Qwen Code viser deres sessioner og tokens, når du har brugt dem. Udbyderabonnementer og nøgler, du bruger gennem pi, omp eller opencode, dukker også op: OpenCode Zen og Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan og Synthetic med deres grænser; Fireworks, OpenRouter og DeepSeek med deres forudbetalte saldi; og de modeller, du kører på din egen hardware, under Local models. Hver agent tælles én gang, under den, der fakturerer den, uanset hvor mange harnesser du driver den igennem.

Venstreklik på bjælkeikonet for at få panelet, højreklik for at starte din standardagent. Brugsregistreringerne bag det gendannes hvert 15. minut af omarchy agent usage-update, og panelet kan endda flette brug fra dine andre maskiner via en synkroniseret mappe. Se README under $OMARCHY_PATH/shell/plugins/agents/ for de fulde indstillinger.

Flere abonnementer

Hvis du betaler for mere end ét Claude-, Codex- eller Grok-abonnement - et personligt Max og et til arbejde, for eksempel - kan Omarchy holde dem alle logget ind og skifte mellem dem. Tilføj et abonnement med + i agentpanelet, som fører dig igennem det lige der, eller med omarchy agent account add claude Work (eller codex eller grok). Det installerer CLI’en, hvis den mangler. Den første konto for en udbyder logger ind gennem din normale browser, lige der, hvor CLI’en altid kigger. Hver efterfølgende logger ind gennem et privat vindue, så den konto, din browser allerede er logget ind på, ikke bliver valgt ved en fejl; log ind der som den konto, du tilføjer, og luk først ethvert privat vindue, du allerede havde åbent. Log aldrig ud af CLI’en for at gøre dette: At logge ud tilbagekalder det gemte login, og den konto skulle tilføjes igen.

For at kopiere dine abonnementslogins til en anden Omarchy-maskine over SSH skal du køre omarchy agent account copy user@laptop. Afsenderen leverer en midlertidig modtager, når destinationen ikke har en installeret, så ældre Omarchy-maskiner kan modtage konti uden en opdatering. Installerede modtagere har forrang. Dette kopierer alle Claude-, Codex- og Grok-abonnementer; tilføj udbydernavne for at vælge dem, som i omarchy agent account copy laptop claude. Kontonavne og kommando-ID’er matcher kilden, herunder konti, der allerede findes på destinationen. Urelaterede destinationskonti får et numerisk suffiks, hvis deres navne er i konflikt, og indstillinger, færdigheder, plugins og samtalehistorik forbliver lokale på hver maskine.

Eksisterende legitimationsoplysninger på destinationen bevares. En kildekonto, der allerede er logget ind der, får sit navn synkroniseret uden at erstatte dens legitimationsoplysninger; andre konti tilføjes ved siden af den. For at erstatte gemte legitimationsoplysninger for matchende konti skal du bruge omarchy agent account copy --replace laptop claude, efter at du har afsluttet den kontos sessioner på destinationen. En frisk destination får også kildens aktive konto og skiftepræferencer; en etableret destination beholder sine egne.

Legitimationsoplysninger rejser gennem SSH og gemmes i private filer på destinationen, så kopiér kun til maskiner, du stoler på. Dette er en engangskopi, ikke løbende synkronisering. Codex’ refresh tokens kan roteres af en anden maskine, hvilket efterlader et kopieret login med behov for fornyelse; separate logins forbliver det mest pålidelige valg til samtidig brug på flere maskiner. Se Codex’ vejledning om kontogodkendelse.

Én konto pr. udbyder er aktiv, og hver ny session starter som den: cx, cy, et almindeligt claude, codex eller grok, alt, hvad der startes gennem omarchy agent, og scripts eller editorer, der finder CLI’en på PATH. Skift med omarchy agent account use work (og tilbage med omarchy agent account use main), eller i panelet ved at trykke på en kontos nummer og derefter Enter (eller klikke på dens Use-knap). Sessioner, der allerede kører, forbliver på den konto, de startede med. Samtalehistorik, indstillinger, færdigheder og plugins deles på tværs af konti, så claude --continue i samme mappe fortsætter, hvor du slap, på den nye konto.

Med mere end én konto viser panelet hver kontos grænser side om side, med den aktive markeret. Som standard giver Omarchy dig besked, når den aktive konto passerer 95 % af en grænse, og klik på notifikationen skifter til kontoen med mest råderum. Hold musen over en kontos linje i panelet, og klik på Autoswitch, der vises ved siden af Use (eller tryk på m), eller kør omarchy agent account mode auto, for at få den til at skifte af sig selv i stedet; mens den er slået til, tager Autoswitch Uses plads, og klik på den igen går tilbage til at give besked. Tilføj et tal for at ændre tærsklen, som i omarchy agent account mode auto 90. Hvis alle konti er over tærsklen, får du besked én gang sammen med, hvilken konto der først bliver fri. Mens en aktiv konto er inden for 15 point af sin tærskel (80 % som standard), tjekkes dens grænser hvert tredje minut i stedet for hvert 15.

omarchy agent account list viser alle konti og deres seneste grænser, omarchy agent account remove work glemmer én, og omarchy agent account rename primary Hey omdøber én (eller klik på en kontos navn i panelet). Disse kommandoer virker på din standardagents konti; for at nå den anden udbyder skal du navngive den først, som i omarchy agent account use codex side. Det login, du allerede havde i ~/.claude eller ~/.codex, er Main-kontoen og bliver, hvor den er. En konto, der har stået ubrugt i mere end cirka otte timer, kan vise Sign-in required; klik på den for at logge den konto ind igen direkte i panelet, eller start en session i den, hvilket opdaterer loginnet af sig selv. MCP-servere, du havde, da en konto blev tilføjet, følger med til den, men dem, du tilføjer senere med claude mcp add, når kun den konto, du tilføjede dem i. Claude Desktop og værktøjer, der er konfigureret med en absolut sti til en CLI-binærfil, følger ikke med skiftet. En eksplicit CLAUDE_CONFIG_DIR, CODEX_HOME eller GROK_HOME har forrang over den valgte konto.

Nedbrudsdiagnose

Omarchy overvåger systemd-coredump for procesnedbrud. Når noget segfaulter, får du en “Process crashed”-notifikation - klik på den, og nedbruddet overdrages til din standardagent sammen med Omarchys diagnose-crash-færdighed, som fører agenten gennem at fastslå fakta fra core dumpet og afgøre, om nedbruddet er værd at rapportere upstream. Du kan også køre den manuelt mod enhver PID fra coredumpctl list med omarchy agent crash <pid>.

Overvågningen er slået til som standard. Slå den fra under Trigger > Toggle > Crash Capture (eller med omarchy toggle crash-capture), og notifikationerne stopper; omarchy agent crash <pid> virker stadig manuelt.

Nedbrud kan også gøres tavse ét program ad gangen, hvilket er det, diagnosen tilbyder dig til sidst. omarchy crash mute hyprland stopper notifikationerne kun for det program, omarchy crash mute hyprland off bringer dem tilbage, og omarchy crash mute alene viser, hvad du har gjort tavst. Den tager binærfilens sti lige så gerne som dens navn, så omarchy crash mute /usr/bin/hyprland gør det samme. Sæt et navn med et mellemrum i anførselstegn, som i omarchy crash mute 'Some App'. Alt andet giver stadig besked, og programmet, der er gjort tavst, går stadig ned - dette skjuler påmindelsen, det løser ingenting.

Skrivebordsapps

Menuen Install > AI indeholder også et par grafiske AI-apps: ChatGPT-skrivebordsappen, Claude-skrivebordsappen (Anthropics Linux-beta med fanerne Chat, Cowork og Claude Code), Grok Bot til at chatte med xAI’s modeller, Hermes Desktop, OpenClaw, Perplexity-skrivebordsappen og T3 Code. Grok Bot er skrivebordschatappen. Kodeagenten er grok-kommandoen.

Hermes Desktop er den, du skal kende til, fordi en maskine har én Hermes, og den tilhører appen: Hermes installeres kun nogensinde gennem appen, og den hermes-kommando, standardagenten kører, er appens. At vælge Hermes som standardagent installerer det samme som Install > AI-punktet: pakken og en Hermes-runtime under ~/.hermes, sat op af Hermes’ eget installationsprogram, hvilket tager et par minutter første gang. Den runtime er den ene Hermes, som terminalens hermes-kommando, standardagenten og appen alle bruger, og den opdaterer sig selv med hermes update i stedet for at vente på en Omarchy-udgivelse. Installationen giver også Hermes Omarchy-temaet som et skin ved navn omarchy, som alle Hermes-overflader følger, når du skifter tema; vælg et andet under Hermes’ Appearance-indstillinger eller med /skin, hvis du hellere vil være fri for det, og Omarchy lader det valg være i fred. At fjerne appen under Remove > AI lukker Hermes først, gatewayen inklusive, tager runtime med sig og beholder dine chats, minder og de færdigheder, Hermes skrev til sig selv, medmindre du siger andet: Den spørger, med nej som standard, om disse data og dine forbindelsesindstillinger også skal væk.

OpenClaws skrivebordsoplevelse er dens Control UI, som åbner som en webapp bakket op af dens egen lokale gateway. OpenClaw bor i ~/.openclaw og opdaterer sig selv: Brug Control UI’s “Update Gateway”-knap, eller kør openclaw update, og gatewayen genstarter på den nye version. Omarchy vælger kun den udgivelse, en frisk installation starter fra. At fjerne OpenClaw under Remove > AI tager gatewaytjenesten og appen med sig og spørger derefter, om ~/.openclaw også skal væk, da den rummer dine chats og legitimationsoplysninger sammen med OpenClaw selv og de plugin-runtimes, den downloader; standarden beholder den, og installation af OpenClaw igen samler den op igen.

T3 Code kører fra sin officielle AppImage-udgivelse i ~/.local/share/t3code i stedet for fra en pakke, så den opdaterer sig selv. Installationen spørger, om den skal starte på Stable- eller Nightly-kanalen; skift senere i T3 Codes indstillinger. Dine tråde og indstillinger bor i ~/.t3, og at fjerne T3 Code under Remove > AI tager dem med sig.

Lokale LLM’er

Omarchy anbefaler to måder at køre lokale LLM-modeller på: LM Studio og Ollama. LM Studio giver en GUI-grænseflade til at finde open-weight-modeller, installere dem og køre dem. Det er en god måde at komme nemt i gang på. Ollama tilbyder en CLI til at gøre det samme. Men hvis du er ny inden for lokale modeller, ville jeg starte med LM Studio. Du kan installere begge under Install > AI i Omarchy Menu.

Omarchy-færdigheden

Agentfærdigheder hjælper AI med at bruge specifikke værktøjer på en specifik måde, og Omarchy følger med en standardfærdighed til at skræddersy systemet. Som at justere din Hyprland-konfiguration, tilpasse bjælken eller endda skabe et nyt tema fra bunden. Den er symlinket ind i færdighedsmapperne 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 placering ~/.agents/skills, så de fleste harnesser samler den op automatisk.

Men du bør behandle denne færdighed som eksperimentel. Forskellige modeller vil bruge den med forskellig effekt. Det er bedst at køre i planlægningstilstand først, så du har en idé om, hvad agenten gerne vil ændre. Og vær så klar til at rulle ændringer tilbage eller endda køre omarchy reinstall configs, hvis agenten laver rod i det hele.