Handleiding
AI
Omarchy bevat launchers voor de onderstaande coding agents zonder een standaard voor je te kiezen. Voer een commando uit om de CLI ervan bij het eerste gebruik te installeren en authenticeer vervolgens wanneer daarom wordt gevraagd. Hermes is de uitzondering: er wordt bij het eerste gebruik niets voor geïnstalleerd, en het kiezen ervan installeert Hermes Desktop, zoals Desktop-apps hieronder uitlegt.
| Commando | 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 van Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, de gratis, door advertenties ondersteunde coding agent van Codebuff |
grok |
Grok Build van xAI |
hermes |
Hermes, de agent van Nous Research |
kilo |
Kilo, een op OpenCode gebaseerde coding agent |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, de coding agent van MiniMax |
muse |
Muse Code, de coding agent van Meta |
omp |
Oh My Pi |
ori |
Ori, de harness van OpenRouter |
pi |
Pi van Mario Zechner |
qwen |
Qwen Code, de coding agent van Alibaba |
ori is de vreemde eend in de bijt: het draait de andere harnesses tegen de volledige modelcatalogus van OpenRouter, dus ori claude, ori codex of ori opencode starten die agents op welk model je ook naar ze wijst, en ori code is de eigen agent van Ori.
Agents installeren en bijwerken
Met uitzondering van Hermes gebruiken deze agents de lazy installation van mise: de eerste start installeert de CLI, en latere starts hergebruiken die. mise controleert een geïnstalleerde agent ook hoogstens eens per vier uur op een nieuwe release, vlak voordat hij start of op de achtergrond bij een shell-prompt. Als die update mislukt of je offline bent, draait de geïnstalleerde versie. omarchy update werkt geïnstalleerde agents bij samen met de rest van Omarchy, en mup werkt alleen door mise beheerde tools bij.
De eigen updater van een agent, zoals claude update, codex update of een updateknop in een app, werkt de door mise beheerde installatie niet bij. codex update mislukt, en claude update kan succes melden terwijl het een afzonderlijke kopie installeert die mise niet bijhoudt. Als je liever de native installer en updater van een agent gebruikt, voeg die dan toe aan disable_tools; zie Preinstalled CLI tools.
Om alle geconfigureerde lazy tools te installeren voordat je ze nodig hebt, voer je mise install --include-lazy uit. Dit omvat zowel de andere standaard CLI-tools van Omarchy als de agents. Zie Preinstalled CLI tools voor het installeren van één enkele tool of het gebruiken van je eigen installatie.
grok wordt geïnstalleerd via het first-party grok-pakket van mise, op dezelfde manier als claude en codex. Voer grok uit, of kies het onder Setup > Defaults > Agent. Sla de curl | bash-installer op x.ai over. Dat pad plaatst een tweede kopie in ~/.grok/bin, zet die vooraan op PATH en overschrijft de wrapper van Omarchy.
dsh opent zijn browser-UI op 127.0.0.1:3080, met de startmap als standaard werkruimte. De browser-UI neemt geen startprompt aan, dus omarchy agent prompt opent hem met de prompt op je klembord om te plakken. Omarchy start hem met de no-approval-machtigingspreset van DeepSeek. DeepSeek Harness uploadt sessielogs naar DeepSeek wanneer je de officiële model-API ervan gebruikt; schakel dat uit onder Settings > General > Upload Session Log in de browser-UI. Feedback die je eraan stuurt, wordt ook met de sessie geüpload, tenzij je hem start met DSH_TELEMETRY_MODE=DISABLED.
De standaardagent
Kies je standaardagent met omarchy default agent <name> of onder Setup > Defaults > Agent in het Omarchy Menu (Super + Space). Als de agent nog niet is geïnstalleerd, installeert het kiezen ervan hem eerst. Een verse Omarchy nodigt je met een eenmalige melding uit om deze keuze te maken.
Het kiezen van Claude probeert ook de browserextensie ervan in te stellen voor Chromium, Chrome, Brave, Brave Origin en Edge. De installatie van de extensie geldt voor alle gebruikers en kan om je systeemwachtwoord vragen; het annuleren of mislukken van de installatie van de extensie selecteert en start Claude nog steeds. Herstart je browser, schakel de extensie in als daarom wordt gevraagd en meld je aan bij Claude om de verbinding te voltooien. Voer /chrome uit in Claude om de verbinding te controleren. Firefox en Zen ondersteunen deze extensie niet. Als Claude al je standaard was voordat deze installatie werd toegevoegd, selecteer hem dan opnieuw om de extensie te installeren.
Zodra je hebt gekozen, start Super + Shift + Ctrl + A de standaardagent in een speciaal terminalvenster (of opent de kiezer als je nog niet hebt gekozen). Je kunt hem ook rechtstreeks een taak geven met omarchy agent prompt "Review this project". Freebuff en DeepSeek Harness nemen geen startprompt aan, dus zij openen in plaats daarvan met de prompt op je klembord om te plakken. Agents die op deze manier worden gestart, draaien onbeheerd in hun respectieve modi waarin ze niet stoppen om te vragen, dus wees erop voorbereid dat ze daadwerkelijk dingen gaan doen! MiniMax Code heeft geen dergelijke modus voor zijn interactieve sessies, dus die vraagt zoals gebruikelijk om machtigingen. En omdat agents weigeren vertrouwen te onthouden voor je thuismap, starten starts vanuit $HOME in plaats daarvan in ~/Work.
Er zijn ook terminal-snelkoppelingen: a draait de standaardagent inline in de huidige terminal, terwijl c, cx en cy OpenCode, Claude Code en Codex rechtstreeks starten (wederom in hun modi met automatische goedkeuring). Them-wijzigingen synchroniseren ook naar de agents: Claude Code, Pi, OpenCode en Hermes (zodra Omarchy het heeft geïnstalleerd) volgen allemaal mee wanneer je het Omarchy-thema wisselt.
Het agentenpaneel
De bovenste balk heeft een agentenpictogram. Voordat je een agent hebt ingesteld, leidt het paneel ervan je door het aanmelden bij Claude, Codex of Grok, en de eerste wordt je standaardagent. Daarna zet het paneel elk abonnement op één pagina: elke agent en elk account met zijn abonnement, een meter voor elk van zijn sessielimieten van 5 uur en wekelijkse limieten met de tijd tot hij wordt gereset (beweeg erover voor het exacte percentage), of het resterende vooruitbetaalde saldo, onder een regel die roteert door wat je over ze allemaal heen hebt gebruikt, zoals tokens deze week en je meest gebruikte model. Onder Make something biedt het starterprompts voor een nieuw thema, een nieuwe plugin of een nieuwe app die de taak overhandigen aan je standaardagent. Apps worden gebouwd op de manier waarop Omarchy’s eigen Hype, Monologue en Omacut zijn gebouwd, in C++ en Qt Quick, volgens de omarchy-app agent skill, en de compiler en Qt-onderdelen die ze nodig hebben, worden meegeleverd geïnstalleerd. Claude Code, Codex, Grok, Kimi, Cursor en zijn Grok Bot-tegoed, GitHub Copilot, Muse, Antigravity, Kimchi en Devin worden out of the box gedekt met hun limieten, en Hermes, Mistral Vibe en Qwen Code tonen hun sessies en tokens zodra je ze hebt gebruikt. Providerabonnementen en -sleutels die je via pi, omp of opencode gebruikt, verschijnen ook: OpenCode Zen en Go, het Z.ai GLM Coding Plan, Ollama Cloud, het MiniMax Token Plan en Synthetic met hun limieten; Fireworks, OpenRouter en DeepSeek met hun vooruitbetaalde saldi; en de modellen die je op je eigen hardware draait onder Local models. Elke agent wordt één keer geteld, onder degene die hem factureert, via hoeveel harnesses je hem ook aanstuurt.
Klik met de linkermuisknop op het balkpictogram voor het paneel, klik met de rechtermuisknop om je standaardagent te starten. De gebruiksrecords erachter worden elke 15 minuten opnieuw gegenereerd door omarchy agent usage-update, en het paneel kan zelfs gebruik van je andere machines samenvoegen via een gesynchroniseerde map. Zie de README onder $OMARCHY_PATH/shell/plugins/agents/ voor de volledige instellingen.
Meerdere abonnementen
Als je betaalt voor meer dan één Claude-, Codex- of Grok-abonnement - bijvoorbeeld een persoonlijke Max en een voor werk - kan Omarchy ze allemaal aangemeld houden en ertussen wisselen. Voeg een abonnement toe met de + in het agentenpaneel, dat je er daar meteen doorheen leidt, of met omarchy agent account add claude Work (of codex, of grok). Het installeert de CLI als die ontbreekt. Het eerste account voor een provider meldt zich aan via je normale browser, precies waar de CLI altijd kijkt. Elk account daarna meldt zich aan via een privévenster, zodat het account waarbij je browser al is aangemeld niet per ongeluk wordt opgepikt; meld je daar aan als het account dat je toevoegt, en sluit eerst elk privévenster dat je al open had. Meld je hiervoor nooit af bij de CLI: afmelden trekt de opgeslagen aanmelding in, en dat account zou opnieuw moeten worden toegevoegd.
Om je abonnementsaanmeldingen via SSH naar een andere Omarchy-machine te kopiëren, voer je omarchy agent account copy user@laptop uit. De verzender levert een tijdelijke ontvanger wanneer de bestemming er geen geïnstalleerd heeft, zodat oudere Omarchy-machines accounts kunnen ontvangen zonder een update. Geïnstalleerde ontvangers hebben voorrang. Dit kopieert alle Claude-, Codex- en Grok-abonnementen; voeg providernamen toe om ze te selecteren, zoals in omarchy agent account copy laptop claude. Accountnamen en commando-ID’s komen overeen met de bron, inclusief accounts die al op de bestemming aanwezig zijn. Niet-gerelateerde bestemmingsaccounts krijgen een numeriek achtervoegsel als hun namen botsen, en instellingen, skills, plugins en gespreksgeschiedenis blijven lokaal op elke machine.
Bestaande bestemmingsreferenties blijven behouden. Een bronaccount dat daar al is aangemeld, krijgt zijn naam gesynchroniseerd zonder zijn referenties te vervangen; andere accounts worden ernaast toegevoegd. Om opgeslagen referenties voor overeenkomende accounts te vervangen, gebruik je omarchy agent account copy --replace laptop claude nadat je de sessies van dat account op de bestemming hebt afgesloten. Een verse bestemming krijgt ook het actieve account en de wisselvoorkeuren van de bron; een gevestigde bestemming behoudt haar eigen.
Referenties reizen via SSH en worden opgeslagen in priv bestanden op de bestemming, dus kopieer alleen naar machines die je vertrouwt. Dit is een eenmalige kopie, geen doorlopende synchronisatie. Codex refresh tokens kunnen door een andere machine worden geroteerd, waardoor een gekopieerde aanmelding moet worden vernieuwd; afzonderlijke aanmeldingen blijven de betrouwbaarste keuze voor gelijktijdig gebruik op meerdere machines. Zie de richtlijnen voor accountauthenticatie van Codex.
Eén account per provider is actief, en elke nieuwe sessie start als dat account: cx, cy, een gewone claude, codex of grok, alles wat via omarchy agent wordt gestart, en scripts of editors die de CLI op PATH vinden. Wissel met omarchy agent account use work (en terug met omarchy agent account use main), of in het paneel door op het nummer van een account en vervolgens op Enter te drukken (of op de Use-knop ervan te klikken). Sessies die al draaien, blijven op het account waarmee ze zijn gestart. Gespreksgeschiedenis, instellingen, skills en plugins worden gedeeld over accounts heen, dus claude --continue in dezelfde map gaat verder waar je was gebleven op het nieuwe account.
Met meer dan één account toont het paneel de limieten van elk account naast elkaar, met het actieve account gemarkeerd. Standaard meldt Omarchy je wanneer het actieve account 95% van een limiet overschrijdt, en klikken op de melding wisselt naar het account met de meeste ruimte. Beweeg over de regel van een account in het paneel en klik op de Autoswitch die naast Use verschijnt (of druk op m), of voer omarchy agent account mode auto uit, om het in plaats daarvan vanzelf te laten wisselen; terwijl het aan staat, neemt Autoswitch de plaats van Use in, en er nogmaals op klikken gaat terug naar melden. Voeg een nummer toe om de drempel te wijzigen, zoals in omarchy agent account mode auto 90. Als elk account boven de drempel zit, hoor je dat één keer, samen met welk account als eerste vrijkomt. Terwijl een actief account binnen 15 punten van zijn drempel zit (80% bij de standaard), worden zijn limieten elke drie minuten gecontroleerd in plaats van elke 15.
omarchy agent account list toont elk account en zijn nieuwste limieten, omarchy agent account remove work vergeet er een, en omarchy agent account rename primary Hey hernoemt er een (of klik op de naam van een account in het paneel). Deze commando’s werken op de accounts van je standaardagent; om de andere provider te bereiken, noem je die eerst, zoals in omarchy agent account use codex side. De aanmelding die je al had in ~/.claude of ~/.codex is het Main-account en blijft waar hij is. Een account dat meer dan ongeveer acht uur ongebruikt is gebleven, kan Sign-in required tonen; klik erop om dat account meteen in het paneel opnieuw aan te melden, of start er een sessie in, wat de aanmelding vanzelf vernieuwt. MCP-servers die je had toen een account werd toegevoegd, komen met hem mee, maar servers die je later toevoegt met claude mcp add bereiken alleen het account waarin je ze hebt toegevoegd. Claude Desktop en tools die zijn geconfigureerd met een absoluut pad naar een CLI-binary volgen de wissel niet. Een expliciete CLAUDE_CONFIG_DIR, CODEX_HOME of GROK_HOME heeft voorrang op het geselecteerde account.
Crashdiagnose
Omarchy houdt systemd-coredump in de gaten voor procescrashes. Wanneer iets segfault, krijg je een “Process crashed”-melding - klik erop, en de crash wordt overhandigd aan je standaardagent samen met de diagnose-crash skill van Omarchy, die de agent begeleidt bij het vaststellen van de feiten uit de core dump en het beslissen of de crash het waard is om upstream te rapporteren. Je kunt hem ook handmatig draaien tegen elke PID uit coredumpctl list met omarchy agent crash <pid>.
Het in de gaten houden staat standaard aan. Schakel het uit onder Trigger > Toggle > Crash Capture (of met omarchy toggle crash-capture) en de meldingen stoppen; omarchy agent crash <pid> werkt nog steeds handmatig.
Crashes kunnen ook één programma tegelijk worden gedempt, wat de diagnose je aan het einde aanbiedt. omarchy crash mute hyprland stopt de meldingen alleen voor dat programma, omarchy crash mute hyprland off brengt ze terug, en omarchy crash mute op zichzelf vermeldt wat je hebt gedempt. Het neemt het pad van de binary net zo graag aan als zijn naam, dus omarchy crash mute /usr/bin/hyprland doet hetzelfde. Zet een naam met een spatie erin tussen aanhalingstekens, zoals in omarchy crash mute 'Some App'. Al het andere blijft melden, en het gedempte programma blijft crashen - dit verbergt de herinnering, het lost niets op.
Desktop-apps
Het menu Install > AI bevat ook een paar grafische AI-apps: de ChatGPT desktop-app, de Claude desktop-app (de Linux-bèta van Anthropic, met tabbladen voor Chat, Cowork en Claude Code), Grok Bot om te chatten met de modellen van xAI, Hermes Desktop, OpenClaw, de Perplexity desktop-app en T3 Code. Grok Bot is de desktop-chatapp. De coding agent is het grok-commando.
Hermes Desktop is degene die je moet kennen, omdat een machine één Hermes heeft, en die is van de app: Hermes wordt alleen ooit via de app geïnstalleerd, en het hermes-commando dat de standaardagent draait, is dat van de app. Hermes kiezen als standaardagent installeert hetzelfde als het item Install > AI: het pakket, en een Hermes-runtime onder ~/.hermes die is ingesteld door de eigen installer van Hermes, wat de eerste keer een paar minuten duurt. Die runtime is de ene Hermes die het terminal-hermes-commando, de standaardagent en de app allemaal gebruiken, en hij werkt zichzelf bij met hermes update in plaats van te wachten op een Omarchy-release. Het installeren ervan geeft Hermes ook het Omarchy-thema als een skin met de naam omarchy, die elk Hermes-oppervlak volgt terwijl je van thema wisselt; kies een andere onder de Appearance-instellingen van Hermes of met /skin als je liever niet hebt dat hij dat doet, en Omarchy laat die keuze met rust. Het verwijderen van de app onder Remove > AI sluit eerst Hermes, inclusief de gateway, neemt die runtime met zich mee, en behoudt je chats, herinneringen en de skills die Hermes voor zichzelf heeft geschreven, tenzij je anders aangeeft: het vraagt, met nee als standaard, of die gegevens en je verbindingsinstellingen ook moeten verdwijnen.
De desktopervaring van OpenClaw is zijn Control UI, die opent als een webapp ondersteund door zijn eigen lokale gateway. OpenClaw leeft in ~/.openclaw en werkt zichzelf bij: gebruik de knop “Update Gateway” van de Control UI of voer openclaw update uit, en de gateway herstart op de nieuwe versie. Omarchy kiest alleen de release waarmee een verse installatie begint. Het verwijderen van OpenClaw onder Remove > AI neemt de gateway-service en de app met zich mee en vraagt vervolgens of ~/.openclaw ook moet verdwijnen, aangezien dat je chats en referenties bevat naast OpenClaw zelf en de plugin-runtimes die het downloadt; de standaard behoudt het, en OpenClaw opnieuw installeren pikt het weer op.
T3 Code draait vanaf zijn officiële AppImage-release in ~/.local/share/t3code in plaats van vanaf een pakket, dus het werkt zichzelf bij. Het installeren ervan vraagt of er op het Stable- of Nightly-kanaal moet worden gestart; wissel later in de instellingen van T3 Code. Je threads en instellingen leven in ~/.t3, en het verwijderen van T3 Code onder Remove > AI neemt ze met zich mee.
Lokale LLM’s
Omarchy raadt twee manieren aan om lokale LLM-modellen te draaien: LM Studio en Ollama. LM Studio biedt een GUI-interface voor het vinden van open-weight modellen, het installeren ervan en het draaien ervan. Het is een geweldige manier om gemakkelijk aan de slag te gaan. Ollama biedt een CLI om dat op vergelijkbare wijze te doen. Maar als je nieuw bent met lokale modellen, zou ik met LM Studio beginnen. Je kunt beide installeren onder Install > AI in het Omarchy Menu.
De Omarchy Skill
Agent skills helpen AI om specifieke tools op een specifieke manier te gebruiken, en Omarchy wordt geleverd met een standaard skill voor het op maat maken van het systeem. Zoals het aanpassen van je Hyprland-config, het aanpassen van de balk, of zelfs het vanaf nul creëren van een nieuw thema. Het is gesymlinkt in de skill-mappen voor Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills en elke ~/.hermes/profiles/*/skills), en de generieke locatie ~/.agents/skills, dus de meeste harnesses pikken het automatisch op.
Maar je moet deze skill als experimenteel beschouwen. Verschillende modellen zullen hem met verschillend effect gebruiken. Het is het beste om eerst in planmodus te draaien, zodat je een idee hebt van wat de agent zou willen veranderen. En wees dan klaar om wijzigingen terug te draaien of zelfs omarchy reinstall configs aan te roepen, als de agent er een puinhoop van maakt.