Priručnik
AI
Omarchy uključuje pokretače za agente za programiranje navedene u nastavku, a da ne odabire zadanog umjesto vas. Pokrenite naredbu da biste pri prvoj upotrebi instalirali njezin CLI, zatim se autentificirajte kada se to zatraži. Hermes je iznimka: za njega se pri prvoj upotrebi ništa ne instalira, a odabirom njega instalira se Hermes Desktop, kao što je objašnjeno u nastavku u odjeljku Aplikacije za radnu površinu.
| Naredba | 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 od Cognitiona |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuffov besplatni agent za programiranje koji se financira oglasima |
grok |
Grok Build od xAI-ja |
hermes |
Hermes, agent tvrtke Nous Research |
kilo |
Kilo, agent za programiranje temeljen na OpenCodeu |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMaxov agent za programiranje |
muse |
Muse Code, Metin agent za programiranje |
omp |
Oh My Pi |
ori |
Ori, OpenRouterov okvir za pokretanje |
pi |
Pi Marija Zechnera |
qwen |
Qwen Code, Alibabin agent za programiranje |
ori je iznimka među njima: pokreće druge okvire za pokretanje na cijelom OpenRouterovu katalogu modela, pa ori claude, ori codex ili ori opencode pokreću te agente na bilo kojem modelu na koji ih usmjerite, a ori code je Orijev vlastiti agent.
Instaliranje i ažuriranje agenata
Osim Hermesa, ovi agenti koriste miseovu lijenu instalaciju: prvo pokretanje instalira CLI, a kasnija ga pokretanja ponovno koriste. mise također provjerava ima li instalirani agent novo izdanje najviše jednom svaka četiri sata, neposredno prije nego što se pokrene ili u pozadini na odzivniku ljuske. Ako to ažuriranje ne uspije ili ste izvan mreže, pokreće se instalirana verzija. omarchy update ažurira instalirane agente s ostatkom Omarchyja, a mup ažurira samo alate kojima upravlja mise.
Vlastiti program za ažuriranje agenta, kao što je claude update, codex update ili gumb za ažuriranje u aplikaciji, ne ažurira instalaciju kojom upravlja mise. codex update ne uspijeva, a claude update može prijaviti uspjeh dok instalira zasebnu kopiju koju mise ne prati. Ako biste radije koristili agentov izvorni program za instalaciju i ažuriranje, dodajte ga u disable_tools; pogledajte Unaprijed instalirani CLI alati.
Da biste instalirali sve konfigurirane lijene alate prije nego što vam zatrebaju, pokrenite mise install --include-lazy. To uključuje i druge Omarchyjeve zadane CLI alate, kao i agente. Pogledajte Unaprijed instalirani CLI alati za instaliranje pojedinačnog alata ili korištenje vlastite instalacije.
grok se instalira putem miseova izvornog paketa grok, na isti način kao claude i codex. Pokrenite grok ili ga odaberite pod Postavljanje > Zadane postavke > Agent. Preskočite program za instalaciju curl | bash na x.ai. Taj put stavlja drugu kopiju u ~/.grok/bin, stavlja je na početak PATH-a i prepisuje Omarchyjev omotač.
dsh otvara svoje sučelje u pregledniku na 127.0.0.1:3080, s direktorijem pokretanja kao zadanim radnim prostorom. Njegovo sučelje u pregledniku ne prima početni upit, pa ga omarchy agent prompt otvara s upitom u vašem međuspremniku koji možete zalijepiti. Omarchy ga pokreće s DeepSeekovom unaprijed postavljenom konfiguracijom dopuštenja bez odobravanja. DeepSeek Harness prenosi zapisnike sesija DeepSeeku kada koristite njegov službeni API za modele; isključite to pod Postavke > Općenito > Prenesi zapisnik sesije u njegovu sučelju u pregledniku. Povratne informacije koje mu pošaljete također se prenose sa sesijom, osim ako ga ne pokrenete s DSH_TELEMETRY_MODE=DISABLED.
Zadani agent
Odaberite svog zadanog agenta naredbom omarchy default agent <name> ili pod Postavljanje > Zadane postavke > Agent u izborniku Omarchy Menu (Super + Space). Ako agent još nije instaliran, odabirom ćete ga najprije instalirati. Novi Omarchy pozvat će vas da napravite ovaj odabir jednokratnom obavijesti.
Odabir Claudea također pokušava postaviti njegovo proširenje za preglednik za Chromium, Chrome, Brave, Brave Origin i Edge. Postavljanje proširenja primjenjuje se na sve korisnike i može zatražiti vašu sistemsku lozinku; otkazivanje ili neuspjela instalacija proširenja i dalje odabire i pokreće Claude. Ponovno pokrenite preglednik, omogućite proširenje ako se to zatraži i prijavite se u Claude da biste dovršili njegovo povezivanje. Pokrenite /chrome u Claudeu da biste provjerili vezu. Firefox i Zen ne podržavaju ovo proširenje. Ako je Claude već bio vaš zadani agent prije nego što je dodano ovo postavljanje, odaberite ga ponovno da biste instalirali proširenje.
Nakon što odaberete, Super + Shift + Ctrl + A pokreće zadanog agenta u namjenskom prozoru terminala (ili otvara birač ako još niste odabrali). Možete ga pokrenuti i izravno u zadatak naredbom omarchy agent prompt "Review this project". Freebuff i DeepSeek Harness ne primaju početni upit, pa se umjesto toga otvaraju s upitom u vašem međuspremniku koji možete zalijepiti. Agenti pokrenuti na ovaj način rade bez nadzora u svojim načinima rada u kojima se ne zaustavljaju da bi pitali, pa budite spremni da doista nešto i naprave! MiniMax Code nema takav način rada za svoje interaktivne sesije, pa traži dopuštenja kao i obično. A budući da agenti odbijaju zapamtiti povjerenje za vaš početni direktorij, pokretanja iz $HOME umjesto toga započinju u ~/Work.
Postoje i prečaci u terminalu: a pokreće zadanog agenta unutar trenutačnog terminala, dok c, cx i cy izravno pokreću OpenCode, Claude Code i Codex (ponovno u njihovim načinima rada s automatskim odobravanjem). Promjene teme također se sinkroniziraju s agentima: Claude Code, Pi, OpenCode i Hermes (nakon što ga Omarchy instalira) svi prate kada promijenite Omarchyjevu temu.
Ploča s agentima
Gornja traka ima ikonu agenata. Prije nego što postavite agenta, njezina vas ploča vodi kroz prijavu u Claude, Codex ili Grok, a prvi od njih postaje vaš zadani agent. Nakon toga ploča stavlja svaku pretplatu na jednu stranicu: svakog agenta i račun s njegovim planom, mjerač za svako od njegovih ograničenja sesije od 5 sati i tjednih ograničenja s vremenom do resetiranja (zadržite pokazivač iznad njega za točan postotak) ili preostali unaprijed plaćeni saldo, ispod retka koji se izmjenjuje kroz ono što ste koristili kod svih njih, kao što su tokeni ovaj tjedan i vaš najkorišteniji model. Pod Napravi nešto nudi početne upite za novu temu, dodatak ili aplikaciju koji zadatak predaju vašem zadanom agentu. Aplikacije se grade na način na koji su izgrađeni Omarchyjevi vlastiti Hype, Monologue i Omacut, u C++-u i Qt Quicku, slijedeći vještinu agenta omarchy-app, a kompajler i dijelovi Qta koji su im potrebni dolaze instalirani. Claude Code, Codex, Grok, Kimi, Cursor i njegova dodjela za Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi i Devin pokriveni su odmah po instalaciji sa svojim ograničenjima, a Hermes, Mistral Vibe i Qwen Code prikazuju svoje sesije i tokene nakon što ih upotrijebite. Planovi davatelja usluga i ključevi koje koristite putem pi, omp ili opencode također se prikazuju: OpenCode Zen i Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan i Synthetic sa svojim ograničenjima; Fireworks, OpenRouter i DeepSeek sa svojim unaprijed plaćenim saldima; te modeli koje pokrećete na vlastitom hardveru pod Lokalni modeli. Svaki se agent broji jednom, kod onoga tko ga naplaćuje, bez obzira na to kroz koliko ga okvira za pokretanje pokrećete.
Kliknite lijevom tipkom miša ikonu na traci za ploču, a desnom tipkom miša za pokretanje zadanog agenta. Zapisi o korištenju koji stoje iza nje ponovno se generiraju svakih 15 minuta naredbom omarchy agent usage-update, a ploča čak može spojiti korištenje s vaših drugih računala putem sinkronizirane mape. Pogledajte README pod $OMARCHY_PATH/shell/plugins/agents/ za sve postavke.
Više pretplata
Ako plaćate više od jednog plana za Claude, Codex ili Grok - recimo osobni Max i poslovni - Omarchy ih sve može držati prijavljenima i kretati se između njih. Dodajte pretplatu znakom + na ploči s agentima, koja vas kroz to vodi upravo tamo, ili naredbom omarchy agent account add claude Work (ili codex, ili grok). Instalira CLI ako nedostaje. Prvi račun za davatelja usluga prijavljuje se putem vašeg uobičajenog preglednika, upravo tamo gdje CLI uvijek traži. Svaki sljedeći prijavljuje se putem privatnog prozora, kako se račun u koji je vaš preglednik već prijavljen ne bi greškom pokupio; prijavite se tamo kao račun koji dodajete i najprije zatvorite svaki privatni prozor koji ste već imali otvoren. Nikada se nemojte odjaviti iz CLI-ja da biste to učinili: odjava opoziva spremljenu prijavu i taj bi se račun morao ponovno dodati.
Da biste kopirali svoje prijave za pretplate na drugo Omarchy računalo putem SSH-a, pokrenite omarchy agent account copy user@laptop. Pošiljatelj isporučuje privremenog primatelja kada odredište nema instaliranog, pa starija Omarchy računala mogu primiti račune bez ažuriranja. Instalirani primatelji imaju prednost. Time se kopiraju sve pretplate za Claude, Codex i Grok; dodajte nazive davatelja usluga da biste ih odabrali, kao u omarchy agent account copy laptop claude. Nazivi računa i ID-jevi naredbi podudaraju se s izvorom, uključujući račune koji su već prisutni na odredištu. Nepovezani odredišni računi dobivaju brojčani sufiks ako im se nazivi sukobljavaju, a postavke, vještine, dodaci i povijest razgovora ostaju lokalni na svakom računalu.
Postojeće odredišne vjerodajnice zadržavaju se. Izvorni račun koji je tamo već prijavljen ima sinkroniziran naziv bez zamjene svojih vjerodajnica; ostali se računi dodaju uz njega. Da biste zamijenili spremljene vjerodajnice za podudarne račune, upotrijebite omarchy agent account copy --replace laptop claude nakon što zatvorite sesije tog računa na odredištu. Novo odredište također dobiva izvorni aktivni račun i postavke prebacivanja; uspostavljeno odredište zadržava svoje.
Vjerodajnice putuju putem SSH-a i pohranjuju se u privatne datoteke na odredištu, pa kopirajte samo na računala kojima vjerujete. Ovo je jednokratno kopiranje, a ne trajna sinkronizacija. Codexovi tokeni za osvježavanje mogu se rotirati na drugom računalu, zbog čega kopirana prijava može trebati obnovu; zasebne prijave ostaju najpouzdaniji odabir za istodobnu upotrebu na više računala. Pogledajte Codexove upute za autentifikaciju računa.
Jedan je račun po davatelju usluga aktivan i svaka nova sesija započinje kao on: cx, cy, običan claude, codex ili grok, bilo što pokrenuto putem omarchy agent te skripte ili uređivači koji CLI pronađu na PATH-u. Prebacite se naredbom omarchy agent account use work (i natrag naredbom omarchy agent account use main) ili na ploči pritiskom na broj računa, a zatim na Enter (ili klikom na njegov gumb Koristi). Sesije koje već rade ostaju na računu s kojim su započele. Povijest razgovora, postavke, vještine i dodaci dijele se među računima, pa claude --continue u istoj mapi nastavlja tamo gdje ste stali na novom računu.
S više od jednog računa ploča prikazuje ograničenja svakog računa jedno pored drugog, s označenim aktivnim. Omarchy vas prema zadanim postavkama obavještava kada aktivni račun prijeđe 95 % ograničenja, a klikom na obavijest prebacujete se na račun s najviše slobodnog prostora. Zadržite pokazivač iznad retka računa na ploči i kliknite Automatsko prebacivanje koje se pojavljuje pored Koristi (ili pritisnite m), ili pokrenite omarchy agent account mode auto, da bi se umjesto toga samo prebacivalo; dok je uključeno, Automatsko prebacivanje zauzima mjesto gumba Koristi, a ponovnim klikom na njega vraćate se na obavještavanje. Dodajte broj da biste promijenili prag, kao u omarchy agent account mode auto 90. Ako je svaki račun iznad praga, čut ćete o tome jednom, zajedno s time koji se račun prvi oslobađa. Dok je aktivni račun unutar 15 bodova od svog praga (80 % pri zadanoj postavci), njegova se ograničenja provjeravaju svake tri minute, a ne svakih 15.
omarchy agent account list prikazuje svaki račun i njegova najnovija ograničenja, omarchy agent account remove work zaboravlja jedan, a omarchy agent account rename primary Hey preimenuje jedan (ili kliknite naziv računa na ploči). Ove naredbe rade na računima vašeg zadanog agenta; da biste dosegnuli drugog davatelja usluga, najprije ga imenujte, kao u omarchy agent account use codex side. Prijava koju ste već imali u ~/.claude ili ~/.codex je Glavni račun i ostaje tamo gdje jest. Račun koji se ne koristi više od otprilike osam sati može prikazivati Potrebna je prijava; kliknite ga da biste taj račun ponovno prijavili upravo na ploči ili pokrenite sesiju u njemu, što samo po sebi osvježava prijavu. MCP poslužitelji koje ste imali kada je račun dodan dolaze s njim, ali oni koje kasnije dodate naredbom claude mcp add dosežu samo račun u kojem ste ih dodali. Claude Desktop i alati konfigurirani s apsolutnim putom do binarne datoteke CLI-ja ne prate prebacivanje. Izričit CLAUDE_CONFIG_DIR, CODEX_HOME ili GROK_HOME ima prednost pred odabranim računom.
Dijagnostika rušenja
Omarchy nadzire systemd-coredump radi rušenja procesa. Kada nešto doživi segmentacijsku pogrešku, dobit ćete obavijest “Process crashed” - kliknite je i rušenje će se predati vašem zadanom agentu zajedno s Omarchyjevom vještinom diagnose-crash, koja agenta vodi kroz utvrđivanje činjenica iz ispisa jezgre i odlučivanje isplati li se rušenje prijaviti uzvodno. Možete je pokrenuti i ručno na bilo koji PID iz coredumpctl list naredbom omarchy agent crash <pid>.
Nadziranje je prema zadanim postavkama uključeno. Isključite ga pod Okidač > Prekidač > Snimanje rušenja (ili naredbom omarchy toggle crash-capture) i obavijesti prestaju; omarchy agent crash <pid> i dalje radi ručno.
Rušenja se također mogu utišati jedno po jedno za svaki program, što vam dijagnostika nudi na kraju. omarchy crash mute hyprland zaustavlja obavijesti samo za taj program, omarchy crash mute hyprland off ih vraća, a samo omarchy crash mute navodi što ste utišali. Prihvaća put binarne datoteke jednako rado kao i njezin naziv, pa omarchy crash mute /usr/bin/hyprland radi istu stvar. Naziv s razmakom stavite u navodnike, kao u omarchy crash mute 'Some App'. Sve ostalo i dalje obavještava, a utišani se program i dalje ruši - ovo skriva podsjetnik, ništa ne popravlja.
Aplikacije za radnu površinu
Izbornik Instaliraj > AI također nosi nekoliko grafičkih AI aplikacija: desktop aplikaciju ChatGPT, desktop aplikaciju Claude (Anthropicovu beta verziju za Linux, s karticama Chat, Cowork i Claude Code), Grok Bot za razgovor s xAI-jevim modelima, Hermes Desktop, OpenClaw, desktop aplikaciju Perplexity i T3 Code. Grok Bot je desktop aplikacija za razgovor. Agent za programiranje je naredba grok.
Hermes Desktop je ona koju trebate poznavati, jer računalo ima jedan Hermes i on pripada aplikaciji: Hermes se ikada instalira samo putem aplikacije, a naredba hermes koju zadani agent pokreće pripada aplikaciji. Odabir Hermesa kao zadanog agenta instalira istu stvar koju instalira stavka Instaliraj > AI: paket i Hermesovo okruženje za izvođenje pod ~/.hermes koje postavlja Hermesov vlastiti program za instalaciju, što prvi put traje nekoliko minuta. To okruženje za izvođenje je onaj jedan Hermes koji koriste terminalska naredba hermes, zadani agent i aplikacija, a ažurira se samo naredbom hermes update, umjesto da čeka Omarchyjevo izdanje. Njegova instalacija također Hermesu predaje Omarchyjevu temu kao izgled nazvan omarchy, koji svaka Hermesova površina prati dok mijenjate teme; odaberite drugi pod Hermesovim postavkama izgleda ili naredbom /skin ako biste radije da to ne čini, a Omarchy taj odabir ostavlja na miru. Uklanjanje aplikacije pod Ukloni > AI najprije zatvara Hermes, uključujući pristupnik, odnosi to okruženje za izvođenje sa sobom i čuva vaše razgovore, sjećanja i vještine koje je Hermes napisao za sebe, osim ako mu ne kažete drugačije: pita, pri čemu je zadani odgovor ne, trebaju li i ti podaci i vaše postavke povezivanja također otići.
OpenClawovo desktop iskustvo je njegovo sučelje Control UI, koje se otvara kao web-aplikacija koju podupire njegov vlastiti lokalni pristupnik. OpenClaw živi u ~/.openclaw i sam se ažurira: upotrijebite gumb “Update Gateway” u sučelju Control UI ili pokrenite openclaw update, a pristupnik se ponovno pokreće na novoj verziji. Omarchy samo odabire izdanje od kojeg nova instalacija započinje. Uklanjanje OpenClawa pod Ukloni > AI odnosi uslugu pristupnika i aplikaciju sa sobom, a zatim pita treba li i ~/.openclaw također otići, budući da to sadrži vaše razgovore i vjerodajnice uz sam OpenClaw i okruženja za izvođenje dodataka koja preuzima; zadana postavka ga čuva, a ponovna instalacija OpenClawa ga ponovno preuzima.
T3 Code radi iz svog službenog izdanja AppImage u ~/.local/share/t3code, a ne iz paketa, pa se sam ažurira. Njegova instalacija pita želite li započeti na kanalu Stable ili Nightly; kasnije se prebacite u postavkama T3 Codea. Vaše niti i postavke žive u ~/.t3, a uklanjanje T3 Codea pod Ukloni > AI odnosi ih sa sobom.
Lokalni LLM-ovi
Omarchy preporučuje dva načina pokretanja lokalnih LLM modela: LM Studio i Ollama. LM Studio pruža GUI sučelje za pronalaženje modela s otvorenim težinama, njihovu instalaciju i pokretanje. To je sjajan način da lako započnete. Ollama nudi CLI za slično postupanje. Ali ako ste novi u lokalnim modelima, ja bih započeo s LM Studiom. Bilo koji od njih možete instalirati pod Instaliraj > AI u izborniku Omarchy Menu.
Vještina Omarchy
Vještine agenata pomažu umjetnoj inteligenciji koristiti određene alate na određen način, a Omarchy dolazi sa zadanom vještinom za prilagođavanje sustava. Kao podešavanje vaše konfiguracije Hyprlanda, podešavanje trake ili čak stvaranje nove teme od nule. Simbolički je povezana u direktorije vještina za Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills i svaki ~/.hermes/profiles/*/skills) te generičku lokaciju ~/.agents/skills, pa je većina okvira za pokretanje automatski preuzima.
Ali ovu vještinu trebate tretirati kao eksperimentalnu. Različiti modeli koristit će je s različitim učinkom. Najbolje je prvo je pokrenuti u načinu planiranja, kako biste imali predodžbu o tome što bi agent želio promijeniti. A zatim budite spremni vratiti promjene ili čak pozvati omarchy reinstall configs, ako agent napravi nered od svega.