Preskoči na vsebino
Chapters
  1. Dobrodošli v Omarchy!
  2. Prvi koraki
  3. Prihajate z Maca ali Windowsa
  4. Navigacija
  5. Zgornja vrstica
  6. Teme
  7. Bližnjice na tipkovnici
  8. Poenoteno odložišče in zgodovina
  9. Opomniki
  10. Obvestila
  11. Izvlečenje besedila in narekovanje
  12. Posnetki zaslona in snemanje
  13. Preklopi, nedejavnost in ohranjevalnik zaslona
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Razvojna orodja
  19. Orodja lupine
  20. Funkcije lupine
  21. TUIs
  22. Grafični uporabniški vmesniki
  23. Brskalniki
  24. Komercialne aplikacije/storitve
  25. Spletne aplikacije
  26. Igranje iger
  27. Izpolnjevanje PDF-jev
  28. Windows VM
  29. Drugi paketi
  30. Posodobitve
  31. Dotfiles
  32. Vtičniki lupine
  33. Monitorji
  34. Tipkovnica, miška in sledilna ploščica
  35. Omrežje
  36. Spanje sistema
  37. Overjanje s strojno opremo
  38. Pisave
  39. Ozadja
  40. Poziv
  41. Blagovna znamka
  42. Pogoste prilagoditve
  43. Ustvarjanje lastne teme
  44. Podpora za Mac
  45. Odpravljanje težav
  46. Pogosta vprašanja
  47. Posnetki sistema
  48. Varnost
  49. Omarchy na ...
  50. Namestitev z dvojnim zagonom
  51. Nenadzorovane namestitve

Priročnik

AI

Omarchy vključuje zaganjalnike za spodnje agente za kodiranje, ne da bi namesto vas izbral privzetega. Zaženite ukaz, da ob prvi uporabi namestite njegov CLI, nato se ob pozivu prijavite. Hermes je izjema: ob prvi uporabi se zanj ne namesti nič, izbira pa namesti Hermes Desktop, kot je razloženo v spodnjem razdelku Namizne aplikacije.

Ukaz 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 podjetja Cognition
dsh DeepSeek Harness
freebuff Freebuff, brezplačen, z oglasi podprt agent za kodiranje podjetja Codebuff
grok Grok Build podjetja xAI
hermes Hermes, agent podjetja Nous Research
kilo Kilo, agent za kodiranje na osnovi OpenCode
kimi Kimi Code
kiro-cli Kiro CLI
mcode MiniMax Code, agent za kodiranje podjetja MiniMax
muse Muse Code, agent za kodiranje podjetja Meta
omp Oh My Pi
ori Ori, ogrodje podjetja OpenRouter
pi Pi Maria Zechnerja
qwen Qwen Code, agent za kodiranje podjetja Alibaba

ori je izjema: z drugimi ogrodji uporablja celoten katalog modelov OpenRouter, tako da ori claude, ori codex ali ori opencode zaženejo te agente na katerem koli modelu, ki ga določite, ori code pa je Orijev lastni agent.

Namestitev in posodabljanje agentov

Razen Hermesa ti agenti uporabljajo leno namestitev orodja mise: prvi zagon namesti CLI, poznejši zagoni pa ga znova uporabijo. mise prav tako največ enkrat na štiri ure preveri, ali je za nameščenega agenta na voljo nova izdaja, tik pred njegovim zagonom ali v ozadju ob pozivu lupine. Če ta posodobitev ne uspe ali niste povezani v splet, se zažene nameščena različica. omarchy update posodobi nameščene agente skupaj s preostalim delom Omarchyja, mup pa posodobi samo orodja, ki jih upravlja mise.

Agentov lastni program za posodabljanje, kot so claude update, codex update ali gumb za posodobitev v aplikaciji, ne posodobi namestitve, ki jo upravlja mise. codex update ne uspe, claude update pa lahko poroča o uspehu, medtem ko namesti ločeno kopijo, ki je mise ne spremlja. Če bi raje uporabljali agentov izvorni namestitveni program in program za posodabljanje, ga dodajte v disable_tools; glejte Vnaprej nameščena orodja CLI.

Če želite vsa konfigurirana lena orodja namestiti, preden jih potrebujete, zaženite mise install --include-lazy. To poleg agentov vključuje tudi druga privzeta orodja CLI v Omarchyju. Za namestitev posameznega orodja ali uporabo lastne namestitve glejte Vnaprej nameščena orodja CLI.

grok se namesti prek uradnega paketa grok orodja mise, enako kot claude in codex. Zaženite grok ali ga izberite v razdelku Nastavitev > Privzete nastavitve > Agent. Preskočite namestitveni program curl | bash na x.ai. Ta pot postavi drugo kopijo v ~/.grok/bin, jo doda na začetek PATH in prepiše ovojnico Omarchyja.

dsh odpre svoj brskalniški UI na naslovu 127.0.0.1:3080, pri čemer je imenik zagona njegov privzeti delovni prostor. Njegov brskalniški UI ne sprejme začetnega poziva, zato ga omarchy agent prompt odpre s pozivom na odložišču, ki ga lahko prilepite. Omarchy ga zažene s prednastavitvijo dovoljenj brez odobritve podjetja DeepSeek. DeepSeek Harness naloži dnevnike sej k DeepSeeku, ko uporabljate njegov uradni API za modele; to izklopite v razdelku Nastavitve > Splošno > Upload Session Log v njegovem brskalniškem UI. Tja poslane povratne informacije se naložijo skupaj s sejo, razen če ga zaženete z DSH_TELEMETRY_MODE=DISABLED.

Privzeti agent

Privzetega agenta izberite z omarchy default agent <name> ali v razdelku Nastavitev > Privzete nastavitve > Agent v meniju Omarchy (Super + Space). Če agent še ni nameščen, ga izbira najprej namesti. Svež Omarchy vas bo k tej izbiri povabil z enkratnim obvestilom.

Izbira Claude poskusi nastaviti tudi njegovo razširitev za brskalnik za Chromium, Chrome, Brave, Brave Origin in Edge. Nastavitev razširitve velja za vse uporabnike in lahko zahteva vaše sistemsko geslo; preklic ali neuspešna namestitev razširitve še vedno izbere in zažene Claude. Znova zaženite brskalnik, ob pozivu omogočite razširitev in se prijavite v Claude, da dokončate povezavo. Zaženite /chrome v Claude, da preverite povezavo. Firefox in Zen te razširitve ne podpirata. Če je bil Claude vaš privzeti agent že, preden je bila ta nastavitev dodana, ga izberite znova, da namestite razširitev.

Ko izberete, Super + Shift + Ctrl + A zažene privzetega agenta v namenskem oknu terminala (ali prikaže izbirnik, če ga še niste izbrali). Zagnati ga lahko tudi naravnost v nalogo z omarchy agent prompt "Review this project". Freebuff in DeepSeek Harness ne sprejmeta začetnega poziva, zato se namesto tega odpreta s pozivom na odložišču, ki ga lahko prilepite. Tako zagnani agenti delujejo brez nadzora v svojih načinih, v katerih se ne ustavijo, da bi vprašali, zato bodite pripravljeni, da bodo dejansko kaj naredili! MiniMax Code za svoje interaktivne seje takega načina nima, zato kot običajno prosi za dovoljenja. In ker agenti nočejo zapomniti si zaupanja za vaš domači imenik, se zagoni iz $HOME začnejo namesto tega v ~/Work.

Na voljo so tudi bližnjice v terminalu: a zažene privzetega agenta v trenutnem terminalu, c, cx in cy pa neposredno zaženejo OpenCode, Claude Code in Codex (spet v njihovih načinih samodejnega odobravanja). Spremembe teme se sinhronizirajo tudi z agenti: Claude Code, Pi, OpenCode in Hermes (ko ga Omarchy namesti) sledijo, ko zamenjate temo Omarchy.

Plošča agentov

V zgornji vrstici je ikona agentov. Preden nastavite agenta, vas njena plošča vodi skozi prijavo v Claude, Codex ali Grok, prvi pa postane vaš privzeti agent. Po tem plošča vse naročnine združi na eni strani: vsakega agenta in račun z njegovim paketom, merilnik za vsako od njegovih 5-urnih omejitev seje in tedenskih omejitev s časom do ponastavitve (za natančen odstotek se zadrži nad njim) ali preostalo vnaprej plačano dobroimetje, pod vrstico, ki se vrti skozi vašo porabo pri vseh, na primer število žetonov ta teden in vaš najpogosteje uporabljeni model. V razdelku Ustvari nekaj ponuja začetne pozive za novo temo, vtičnik ali aplikacijo, ki nalogo predajo vašemu privzetemu agentu. Aplikacije so zgrajene tako, kot so Omarchyjeve lastne Hype, Monologue in Omacut, v jeziku C++ in Qt Quick, z upoštevanjem veščine agenta omarchy-app, potrebni prevajalnik in deli Qt pa so že nameščeni. Claude Code, Codex, Grok, Kimi, Cursor in njegova kvota Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi in Devin so z njihovimi omejitvami zajeti že takoj, Hermes, Mistral Vibe in Qwen Code pa pokažejo svoje seje in žetone, ko jih uporabite. Pojavijo se tudi paketi in ključi ponudnikov, ki jih uporabljate prek pi, omp ali opencode: OpenCode Zen in Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan in Synthetic z njihovimi omejitvami; Fireworks, OpenRouter in DeepSeek z njihovimi vnaprej plačanimi dobroimetji; ter modeli, ki jih izvajate na svoji strojni opremi, v razdelku Lokalni modeli. Vsak agent se šteje enkrat, pri tistem, ki ga zaračuna, ne glede na to, prek koliko ogrodij ga uporabljate.

Levo kliknite ikono v vrstici za ploščo, desno kliknite, da zaženete privzetega agenta. Zapisi o porabi za ploščo se znova ustvarijo vsakih 15 minut z omarchy agent usage-update, plošča pa lahko združi tudi porabo z vaših drugih naprav prek sinhronizirane mape. Za vse nastavitve glejte README v $OMARCHY_PATH/shell/plugins/agents/.

Več naročnin

Če plačujete za več kot en paket Claude, Codex ali Grok - na primer osebni Max in službenega - lahko Omarchy vse ohrani prijavljene in preklaplja med njimi. Naročnino dodajte z + na plošči agentov, ki vas tam vodi skozi postopek, ali z omarchy agent account add claude Work (ali codex ali grok). Če CLI manjka, ga namesti. Prvi račun za ponudnika se prijavi prek vašega običajnega brskalnika, natančno tam, kjer CLI vedno išče. Vsak naslednji se prijavi prek zasebnega okna, tako da se račun, v katerega je brskalnik že prijavljen, pomotoma ne pobere; tam se prijavite kot račun, ki ga dodajate, in najprej zaprite vsa zasebna okna, ki jih že imate odprta. Za to se nikoli ne odjavite iz CLI: odjava prekliče shranjeno prijavo in ta račun bi bilo treba znova dodati.

Če želite prijave naročnin kopirati v drugo napravo Omarchy prek SSH, zaženite omarchy agent account copy user@laptop. Pošiljatelj priskrbi začasnega sprejemnika, če ga cilj nima nameščenega, tako da lahko starejše naprave Omarchy prejmejo račune brez posodobitve. Nameščeni sprejemniki imajo prednost. To kopira vse naročnine Claude, Codex in Grok; dodajte imena ponudnikov, da jih izberete, kot v omarchy agent account copy laptop claude. Imena računov in ID-ji ukazov se ujemajo z izvorom, vključno z računi, ki so na cilju že prisotni. Nepovezani ciljni računi ob navzkrižju imen prejmejo številsko pripono, nastavitve, veščine, vtičniki in zgodovina pogovorov pa ostanejo lokalni za vsako napravo.

Obstoječe ciljne poverilnice se ohranijo. Izvorni račun, ki je tam že prijavljen, dobi sinhronizirano ime, ne da bi se njegove poverilnice zamenjale; drugi računi se dodajo poleg njega. Če želite shranjene poverilnice za ujemajoče se račune zamenjati, uporabite omarchy agent account copy --replace laptop claude, ko na cilju zaprete seje tega računa. Svež cilj dobi tudi izvorni aktivni račun in nastavitve preklapljanja; uveljavljen cilj ohrani svoje.

Poverilnice potujejo prek SSH in so na cilju shranjene v zasebnih datotekah, zato kopirajte samo v naprave, ki jim zaupate. To je enkratno kopiranje, ne stalna sinhronizacija. Žetone za osvežitev Codex lahko zamenja druga naprava, zaradi česar kopirana prijava potrebuje obnovitev; ločene prijave ostajajo najzanesljivejša izbira za sočasno uporabo na več napravah. Glejte Codexove smernice za preverjanje pristnosti računov.

Za vsakega ponudnika je aktiven en račun in vsaka nova seja se začne kot ta: cx, cy, navaden claude, codex ali grok, karkoli, kar se zažene prek omarchy agent, ter skripti ali urejevalniki, ki najdejo CLI v PATH. Preklopite z omarchy agent account use work (in nazaj z omarchy agent account use main) ali na plošči tako, da pritisnete številko računa in nato Enter (ali kliknete njegov gumb Use). Seje, ki že tečejo, ostanejo na računu, s katerim so se začele. Zgodovina pogovorov, nastavitve, veščine in vtičniki se delijo med računi, zato claude --continue v isti mapi nadaljuje tam, kjer ste končali z novim računom.

Z več kot enim računom plošča pokaže omejitve vsakega računa drugega ob drugem, pri čemer je aktivni označen. Omarchy vas privzeto obvesti, ko aktivni račun preseže 95 % omejitve, klik obvestila pa preklopi na račun z največ rezerve. Zadrži nad vrstico računa na plošči in kliknite Autoswitch, ki se pojavi poleg Use (ali pritisnite m), ali zaženite omarchy agent account mode auto, da bo preklopil sam; medtem ko je vklopljeno, Autoswitch zasede mesto Use, ponovni klik pa vrne obveščanje. Dodajte številko, da spremenite prag, kot v omarchy agent account mode auto 90. Če so vsi računi nad pragom, boste o tem obveščeni enkrat, skupaj s tem, kateri račun se prvi sprosti. Medtem ko je aktivni račun znotraj 15 točk od svojega praga (80 % pri privzeti nastavitvi), se njegove omejitve preverjajo vsake tri minute in ne vsakih 15.

omarchy agent account list pokaže vsak račun in njegove najnovejše omejitve, omarchy agent account remove work pozabi enega, omarchy agent account rename primary Hey pa enega preimenuje (ali kliknite ime računa na plošči). Ti ukazi delujejo na računih vašega privzetega agenta; če želite doseči drugega ponudnika, ga najprej poimenujte, kot v omarchy agent account use codex side. Prijava, ki ste jo že imeli v ~/.claude ali ~/.codex, je račun Main in ostane tam, kjer je. Račun, ki se ne uporablja več kot približno osem ur, lahko pokaže Potrebna je prijava; kliknite ga, da ta račun znova prijavite kar na plošči, ali začnite sejo v njem, kar prijavo osveži samo. Strežniki MCP, ki ste jih imeli ob dodajanju računa, se preselijo z njim, tisti, ki jih pozneje dodate z claude mcp add, pa dosežejo samo račun, v katerega ste jih dodali. Claude Desktop in orodja, konfigurirana z absolutno potjo do binarne datoteke CLI, preklopu ne sledijo. Izrecna nastavitev CLAUDE_CONFIG_DIR, CODEX_HOME ali GROK_HOME ima prednost pred izbranim računom.

Diagnostika sesutij

Omarchy spremlja systemd-coredump za sesutja procesov. Ko se nekaj sesuje z napako segmentacije, boste prejeli obvestilo »Proces se je sesul« - kliknite ga in sesutje se preda vašemu privzetemu agentu skupaj z veščino diagnose-crash v Omarchyju, ki agenta vodi skozi ugotavljanje dejstev iz izpisa jedra in odločanje, ali je sesutje vredno prijaviti navzgor. Ročno ga lahko zaženete tudi proti kateremu koli PID iz coredumpctl list z omarchy agent crash <pid>.

Spremljanje je privzeto vklopljeno. Izklopite ga v razdelku Sprožilec > Preklop > Zajemanje sesutij (ali z omarchy toggle crash-capture) in obvestila se ustavijo; omarchy agent crash <pid> še vedno deluje ročno.

Sesutja je mogoče utišati tudi za en program naenkrat, kar vam diagnostika ponudi na koncu. omarchy crash mute hyprland ustavi obvestila samo za ta program, omarchy crash mute hyprland off jih vrne, omarchy crash mute sam pa navede, kaj ste utišali. Pot binarne datoteke sprejme prav tako z veseljem kot njeno ime, zato omarchy crash mute /usr/bin/hyprland naredi isto. Ime s presledkom navedite v narekovajih, kot v omarchy crash mute 'Some App'. Vse drugo še vedno obvešča, utišani program pa se še vedno sesuje - to skrije opomnik, ničesar ne popravi.

Namizne aplikacije

Meni Namesti > AI vsebuje tudi nekaj grafičnih aplikacij AI: namizno aplikacijo ChatGPT, namizno aplikacijo Claude (beta za Linux podjetja Anthropic, z zavihki Chat, Cowork in Claude Code), Grok Bot za klepet z modeli xAI, Hermes Desktop, OpenClaw, namizno aplikacijo Perplexity in T3 Code. Grok Bot je namizna aplikacija za klepet. Agent za kodiranje je ukaz grok.

Pri Hermes Desktop velja vedeti to, ker ima naprava en Hermes in ta pripada aplikaciji: Hermes se vedno namesti samo prek aplikacije in ukaz hermes, ki ga zažene privzeti agent, pripada aplikaciji. Izbira Hermesa za privzetega agenta namesti isto stvar kot vnos Namesti > AI: paket in izvajalno okolje Hermes pod ~/.hermes, ki ga nastavi Hermesov lastni namestitveni program, kar ob prvem zagonu traja nekaj minut. To izvajalno okolje je edini Hermes, ki ga uporabljajo ukaz hermes v terminalu, privzeti agent in aplikacija, in se posodablja samo s hermes update, namesto da čaka na izdajo Omarchyja. Namestitev Hermesu preda tudi temo Omarchy kot preobleko z imenom omarchy, ki ji vse površine Hermes sledijo, ko preklapljate teme; v nastavitvah videza Hermes ali z /skin izberite drugo, če ne želite, da bi, in Omarchy bo to izbiro pustil pri miru. Odstranitev aplikacije v razdelku Odstrani > AI najprej zapre Hermes, vključno s prehodom, z njim vzame to izvajalno okolje in ohrani vaše klepete, spomine in veščine, ki si jih je Hermes napisal sam, razen če poveste drugače: vpraša, privzeto z odgovorom ne, ali naj gredo tudi ti podatki in vaše nastavitve povezav.

Namizna izkušnja OpenClaw je njegov Control UI, ki se odpre kot spletna aplikacija, podprta z lastnim lokalnim prehodom. OpenClaw živi v ~/.openclaw in se posodablja sam: uporabite gumb »Posodobi prehod« v Control UI ali zaženite openclaw update in prehod se znova zažene na novi različici. Omarchy izbere samo izdajo, s katero se začne sveža namestitev. Odstranitev OpenClaw v razdelku Odstrani > AI z njim vzame storitev prehoda in aplikacijo ter nato vpraša, ali naj gre tudi ~/.openclaw, saj ta vsebuje vaše klepete in poverilnice skupaj s samim OpenClaw in izvajalnimi okolji vtičnikov, ki jih prenese; privzeta nastavitev ga ohrani in ponovna namestitev OpenClaw ga znova pobere.

T3 Code se izvaja iz uradne izdaje AppImage v ~/.local/share/t3code in ne iz paketa, zato se posodablja sam. Namestitev vas vpraša, ali želite začeti na kanalu Stable ali Nightly; pozneje preklopite v nastavitvah T3 Code. Vaše niti in nastavitve živijo v ~/.t3, odstranitev T3 Code v razdelku Odstrani > AI pa jih vzame s seboj.

Lokalni modeli LLM

Omarchy priporoča dva načina izvajanja lokalnih modelov LLM: LM Studio in Ollama. LM Studio ponuja vmesnik GUI za iskanje modelov z odprtimi utežmi, njihovo namestitev in izvajanje. To je odličen način za preprost začetek. Ollama ponuja CLI za podobno početje. Če pa ste novi pri lokalnih modelih, bi začel z LM Studio. Katero koli od njiju lahko namestite v razdelku Namesti > AI v meniju Omarchy.

Veščina Omarchy

Veščine agentov pomagajo AI uporabljati določena orodja na določen način, Omarchy pa ima privzeto veščino za prilagajanje sistema. Kot je prilagajanje vaše konfiguracije Hyprland, prilagajanje vrstice ali celo ustvarjanje nove teme iz nič. Simbolno je povezana v imenike veščin za Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills in vsak ~/.hermes/profiles/*/skills) ter splošno lokacijo ~/.agents/skills, zato jo večina ogrodij pobere samodejno.

Toda to veščino morate obravnavati kot poskusno. Različni modeli jo bodo uporabljali z različnim učinkom. Najbolje je, da jo najprej zaženete v načrtovalnem načinu, tako da imate predstavo o tem, kaj bi agent rad spremenil. Nato bodite pripravljeni povrniti spremembe ali celo zagnati omarchy reinstall configs, če agent naredi vsega zmedo.