Kézikönyv
AI
Az Omarchy az alábbi kódoló ügynökök indítóit tartalmazza, anélkül, hogy alapértelmezettet választana helyetted. Futtass egy parancsot, hogy első használatkor telepítse a hozzá tartozó CLI-t, majd hitelesítsd magad, amikor kéri. A Hermes a kivétel: nála semmi sem települ első használatkor, és ha őt választod, a Hermes Desktop települ, ahogy az alábbi Asztali alkalmazások szakasz elmagyarázza.
| Parancs | Ügynök |
|---|---|
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 a Cognitiontól |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, a Codebuff ingyenes, hirdetésekkel támogatott kódoló ügynöke |
grok |
Grok Build az xAI-tól |
hermes |
Hermes, a Nous Research ügynöke |
kilo |
Kilo, egy OpenCode-alapú kódoló ügynök |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, a MiniMax kódoló ügynöke |
muse |
Muse Code, a Meta kódoló ügynöke |
omp |
Oh My Pi |
ori |
Ori, az OpenRouter harness-e |
pi |
Mario Zechner Pi-je |
qwen |
Qwen Code, az Alibaba kódoló ügynöke |
Az ori lóg ki a sorból: a többi harness-t futtatja az OpenRouter teljes modellkatalógusán, tehát az ori claude, az ori codex vagy az ori opencode ezeket az ügynököket indítja azon a modellen, amelyikre irányítod őket, az ori code pedig az Ori saját ügynöke.
Ügynökök telepítése és frissítése
A Hermes kivételével ezek az ügynökök a mise lusta telepítését használják: az első indítás telepíti a CLI-t, a későbbi indítások pedig újrahasználják. A mise legfeljebb négyóránként egyszer ellenőrzi, hogy egy telepített ügynöknek megjelent-e új kiadása, közvetlenül az indítása előtt, vagy a háttérben egy shell promptnál. Ha ez a frissítés sikertelen, vagy offline vagy, a telepített verzió fut. Az omarchy update a telepített ügynököket az Omarchy többi részével együtt frissíti, az mup pedig csak a mise által kezelt eszközöket frissíti.
Egy ügynök saját frissítője, például a claude update, a codex update, vagy egy alkalmazásban lévő frissítés gomb, nem frissíti a mise által kezelt telepítést. A codex update sikertelen lesz, a claude update pedig sikeresnek jelentheti magát, miközben egy külön másolatot telepít, amelyet a mise nem követ. Ha inkább egy ügynök saját telepítőjét és frissítőjét használnád, add hozzá a disable_tools listához; lásd az Előre telepített CLI-eszközök szakaszt.
Ha az összes beállított lusta eszközt még azelőtt telepíteni szeretnéd, hogy szükséged lenne rájuk, futtasd a mise install --include-lazy parancsot. Ez az Omarchy többi alapértelmezett CLI-eszközét is tartalmazza az ügynökök mellett. Egyetlen eszköz telepítéséről vagy saját telepítésed használatáról lásd az Előre telepített CLI-eszközök szakaszt.
A grok a mise első féltől származó grok csomagján keresztül települ, ugyanúgy, mint a claude és a codex. Futtasd a grok parancsot, vagy válaszd ki a Beállítás > Alapértelmezések > Ügynök alatt. Hagyd ki az x.ai oldalon lévő curl | bash telepítőt. Az az útvonal egy második másolatot tesz a ~/.grok/bin könyvtárba, a PATH elejére illeszti, és felülírja az Omarchy wrapperét.
A dsh a böngészős felületét a 127.0.0.1:3080 címen nyitja meg, alapértelmezett munkaterületként az indítási könyvtárral. A böngészős felülete nem fogad kezdő promptot, ezért az omarchy agent prompt úgy nyitja meg, hogy a prompt a vágólapodon van, beillesztésre készen. Az Omarchy a DeepSeek jóváhagyás nélküli engedélyezési előbeállításával indítja. A DeepSeek Harness feltölti a munkamenetnaplókat a DeepSeekhez, amikor a hivatalos modell API-ját használod; ezt a böngészős felületén a Settings > General > Upload Session Log alatt kapcsolhatod ki. Az általad küldött visszajelzés is feltöltődik a munkamenettel együtt, hacsak nem DSH_TELEMETRY_MODE=DISABLED mellett indítod.
Az alapértelmezett ügynök
Az alapértelmezett ügynöködet az omarchy default agent <name> paranccsal, vagy az Omarchy Menu (Super + Space) Beállítás > Alapértelmezések > Ügynök pontja alatt választhatod ki. Ha az ügynök még nincs telepítve, a kiválasztása előbb telepíti. Egy friss Omarchy egy egyszeri értesítéssel felkínálja majd neked ezt a választást.
A Claude kiválasztása megpróbálja beállítani a böngészőbővítményét is a Chromium, a Chrome, a Brave, a Brave Origin és az Edge számára. A bővítmény beállítása minden felhasználóra vonatkozik, és kérheti a rendszerjelszavadat; a megszakítás vagy a sikertelen bővítménytelepítés ellenére is a Claude lesz kiválasztva és elindul. Indítsd újra a böngésződet, engedélyezd a bővítményt, ha kéri, és jelentkezz be a Claude-ba a csatlakoztatás befejezéséhez. A kapcsolat ellenőrzéséhez futtasd a /chrome parancsot a Claude-ban. A Firefox és a Zen nem támogatja ezt a bővítményt. Ha a Claude már azelőtt az alapértelmezetted volt, hogy ez a beállítás megjelent volna, válaszd ki újra a bővítmény telepítéséhez.
Miután választottál, a Super + Shift + Ctrl + A egy dedikált terminálablakban indítja el az alapértelmezett ügynököt (vagy felhozza a választót, ha még nem választottál). Egyenesen egy feladattal is elindíthatod az omarchy agent prompt "Review this project" paranccsal. A Freebuff és a DeepSeek Harness nem fogad kezdő promptot, ezért ezek úgy nyílnak meg, hogy a prompt a vágólapodon van, beillesztésre készen. Az így indított ügynökök felügyelet nélkül futnak a saját, kérdezés nélkül továbbhaladó módjukban, úgyhogy készülj fel rá, hogy tényleg csinálni fognak dolgokat! A MiniMax Code interaktív munkameneteihez nincs ilyen mód, ezért az a szokásos módon kér engedélyeket. És mivel az ügynökök nem hajlandók megbízhatóként megjegyezni a home könyvtáradat, a $HOME alól indított indítások helyette a ~/Work könyvtárban indulnak.
Vannak terminálos gyorsbillentyűk is: az a az alapértelmezett ügynököt futtatja soron belül az aktuális terminálban, míg a c, a cx és a cy közvetlenül az OpenCode-ot, a Claude Code-ot és a Codexet indítja (szintén az automatikusan jóváhagyó módjukban). A témaváltások is szinkronizálódnak az ügynökökhöz: a Claude Code, a Pi, az OpenCode és a Hermes (miután az Omarchy telepítette) mind követik, amikor Omarchy témát váltasz.
Az ügynökök panel
A felső sávon van egy ügynökök ikon. Mielőtt beállítottál volna egy ügynököt, a panelje végigvezet a Claude-ba, a Codexbe vagy a Grokba való bejelentkezésen, és az első lesz az alapértelmezett ügynököd. Ezután a panel minden előfizetést egy oldalra tesz: minden ügynököt és fiókot a csomagjával együtt, egy mérőt mindegyik 5 órás munkamenet- és heti korlátjához, a visszaállításáig hátralévő idővel (a pontos százalékért vidd fölé az egeret), vagy a fennmaradó előre fizetett egyenleget, egy sor alatt, amely váltakozva mutatja, mit használtál fel az összesen át, például a tokeneket ezen a héten és a leggyakrabban használt modelledet. A Make something alatt kezdő promptokat kínál egy új témához, pluginhoz vagy alkalmazáshoz, amelyek átadják a feladatot az alapértelmezett ügynöködnek. Az alkalmazások úgy készülnek, ahogy az Omarchy saját Hype, Monologue és Omacut alkalmazásai, C++-ban és Qt Quickben, az omarchy-app ügynök skillt követve, és a hozzájuk szükséges fordító és Qt-összetevők telepítve érkeznek. A Claude Code, a Codex, a Grok, a Kimi, a Cursor és a Grok Bot kerete, a GitHub Copilot, a Muse, az Antigravity, a Kimchi és a Devin a korlátaikkal együtt azonnal lefedettek, a Hermes, a Mistral Vibe és a Qwen Code pedig a munkameneteiket és tokenjeiket mutatják, miután használtad őket. A pi-n, omp-n vagy opencode-on keresztül használt szolgáltatói csomagok és kulcsok is megjelennek: az OpenCode Zen és Go, a Z.ai GLM Coding Plan, az Ollama Cloud, a MiniMax Token Plan és a Synthetic a korlátaikkal; a Fireworks, az OpenRouter és a DeepSeek az előre fizetett egyenlegeikkel; és a saját hardvereden futtatott modellek a Local models alatt. Minden ügynök egyszer számít, annál, aki számlázza, akárhány harness-en keresztül hajtod is.
A panelhez kattints bal gombbal a sáv ikonjára, jobb gombbal pedig indítsd el az alapértelmezett ügynöködet. A mögötte lévő használati rekordokat 15 percenként az omarchy agent usage-update generálja újra, és a panel akár más gépeid használatát is egyesíteni tudja egy szinkronizált mappán keresztül. A teljes beállításokért lásd a README-t a $OMARCHY_PATH/shell/plugins/agents/ alatt.
Több előfizetés
Ha egynél több Claude-, Codex- vagy Grok-csomagért fizetsz - mondjuk egy személyes Maxért és egy munkahelyiért - , az Omarchy mindegyiket bejelentkezve tudja tartani, és tud váltani közöttük. Adj hozzá egy előfizetést az ügynökök panelen lévő +-szal, amely ott helyben végigvezet rajta, vagy az omarchy agent account add claude Work paranccsal (vagy codex, vagy grok). Telepíti a CLI-t, ha hiányzik. Egy szolgáltató első fiókja a normál böngésződön keresztül jelentkezik be, pont ott, ahol a CLI mindig keresi. Minden további egy privát ablakon keresztül jelentkezik be, hogy a fiók, amelybe a böngésződ már be van jelentkezve, véletlenül se kerüljön elő; ott jelentkezz be azzal a fiókkal, amelyet hozzáadsz, és előbb zárd be minden már nyitva lévő privát ablakodat. Ehhez soha ne jelentkezz ki a CLI-ből: a kijelentkezés visszavonja a mentett bejelentkezést, és azt a fiókot újra hozzá kellene adni.
Ha SSH-n keresztül szeretnéd átmásolni az előfizetéses bejelentkezéseidet egy másik Omarchy gépre, futtasd az omarchy agent account copy user@laptop parancsot. A küldő ideiglenes fogadót biztosít, amikor a célgépen nincs ilyen telepítve, így a régebbi Omarchy gépek frissítés nélkül is fogadhatnak fiókokat. A telepített fogadók elsőbbséget élveznek. Ez minden Claude-, Codex- és Grok-előfizetést átmásol; a kiválasztásukhoz adj meg szolgáltatóneveket, ahogy az omarchy agent account copy laptop claude esetében. A fióknevek és parancsazonosítók megegyeznek a forráséival, beleértve a célgépen már meglévő fiókokat is. A nem kapcsolódó célfiókok szám utótagot kapnak, ha a nevük ütközik, és a beállítások, skillek, pluginok és beszélgetési előzmények minden gépen helyben maradnak.
A célgépen már meglévő hitelesítő adatok megmaradnak. Egy olyan forrásfióknak, amely ott már be van jelentkezve, a neve szinkronizálódik a hitelesítő adatainak cseréje nélkül; a többi fiók mellé kerül. A megegyező fiókok mentett hitelesítő adatainak cseréjéhez használd az omarchy agent account copy --replace laptop claude parancsot, miután a célgépen kiléptél az adott fiók munkameneteiből. Egy friss célgép a forrás aktív fiókját és váltási beállításait is megkapja; egy már bejáratott célgép megtartja a sajátjait.
A hitelesítő adatok SSH-n keresztül utaznak, és a célgépen privát fájlokban tárolódnak, ezért csak olyan gépekre másolj, amelyekben megbízol. Ez egy egyszeri másolás, nem folyamatos szinkronizálás. A Codex refresh tokeneket egy másik gép elforgathatja, így egy átmásolt bejelentkezés megújításra szorulhat; a külön bejelentkezések maradnak a legmegbízhatóbb választásnak több gépen való egyidejű használathoz. Lásd a Codex fiókhitelesítési útmutatóját.
Szolgáltatónként egy fiók aktív, és minden új munkamenet akként indul: a cx, a cy, egy sima claude, codex vagy grok, bármi, amit az omarchy agent indít, valamint a scriptek és szerkesztők, amelyek a PATH-on találják meg a CLI-t. Válts az omarchy agent account use work paranccsal (és vissza az omarchy agent account use main paranccsal), vagy a panelen egy fiók számának megnyomásával, majd az Enter lenyomásával (vagy a Use gombjára kattintva). A már futó munkamenetek azon a fiókon maradnak, amelyikkel indultak. A beszélgetési előzmények, beállítások, skillek és pluginok közösek a fiókok között, így a claude --continue ugyanabban a mappában ott folytatja, ahol az új fiókon abbahagytad.
Egynél több fiókkal a panel egymás mellett mutatja minden fiók korlátait, az aktívat megjelölve. Alapértelmezetten az Omarchy értesít, amikor az aktív fiók átlépi egy korlát 95%-át, és az értesítésre kattintva arra a fiókra vált, amelyiknek a legtöbb tartaléka van. Vidd az egeret egy fiók sora fölé a panelen, és kattints a Use mellett megjelenő Autoswitchre (vagy nyomd meg az m billentyűt), vagy futtasd az omarchy agent account mode auto parancsot, hogy helyette magától váltson; amíg ez be van kapcsolva, az Autoswitch veszi át a Use helyét, és újabb kattintásra visszatér az értesítéshez. A küszöb megváltoztatásához adj meg egy számot, ahogy az omarchy agent account mode auto 90 esetében. Ha minden fiók a küszöb fölött van, egyszer értesülsz róla, azzal együtt, hogy melyik fiók szabadul fel először. Amíg egy aktív fiók a küszöbétől 15 ponton belül van (az alapértelmezettnél 80%-nál), a korlátait hárompercenként ellenőrzi 15 perc helyett.
Az omarchy agent account list minden fiókot és a legutóbbi korlátait mutatja, az omarchy agent account remove work elfelejt egyet, az omarchy agent account rename primary Hey pedig átnevez egyet (vagy kattints egy fiók nevére a panelen). Ezek a parancsok az alapértelmezett ügynököd fiókjain működnek; a másik szolgáltató eléréséhez előbb nevezd meg, ahogy az omarchy agent account use codex side esetében. A bejelentkezés, amely már megvolt a ~/.claude vagy a ~/.codex könyvtárban, a Main fiók, és ott marad, ahol van. Egy nyolc óránál hosszabb ideig használatlanul hagyott fiók Sign-in required állapotot mutathat; kattints rá, hogy az adott fiókot újra bejelentkeztesd ott a panelen, vagy indíts egy munkamenetet benne, ami magától frissíti a bejelentkezést. Azok az MCP-kiszolgálók, amelyek egy fiók hozzáadásakor megvoltak, átkerülnek hozzá, de amelyeket később adsz hozzá a claude mcp add paranccsal, csak ahhoz a fiókhoz jutnak el, amelyikben hozzáadtad őket. A Claude Desktop és azok az eszközök, amelyek egy CLI binárishoz abszolút útvonallal vannak beállítva, nem követik a váltást. Egy kifejezett CLAUDE_CONFIG_DIR, CODEX_HOME vagy GROK_HOME elsőbbséget élvez a kiválasztott fiókkal szemben.
Összeomlás-diagnosztika
Az Omarchy figyeli a systemd-coredumpot a folyamatösszeomlásokra. Amikor valami segfaultol, egy “Process crashed” értesítést kapsz - kattints rá, és az összeomlás átkerül az alapértelmezett ügynöködhöz az Omarchy diagnose-crash skilljével együtt, amely végigvezeti az ügynököt a tények core dumpból való megállapításán, és annak eldöntésén, hogy az összeomlást érdemes-e jelenteni upstream. Kézzel is futtathatod bármelyik, a coredumpctl list listájában szereplő PID-re az omarchy agent crash <pid> paranccsal.
A figyelés alapértelmezetten be van kapcsolva. Kapcsold ki a Trigger > Toggle > Crash Capture alatt (vagy az omarchy toggle crash-capture paranccsal), és az értesítések megszűnnek; az omarchy agent crash <pid> kézzel továbbra is működik.
Az összeomlásokat programonként egyenként is el lehet némítani, amit a diagnosztika a végén fel is kínál neked. Az omarchy crash mute hyprland csak annál a programnál állítja le az értesítéseket, az omarchy crash mute hyprland off visszahozza őket, az önmagában futtatott omarchy crash mute pedig felsorolja, mit némítottál el. Ugyanolyan szívesen elfogadja a bináris útvonalát, mint a nevét, tehát az omarchy crash mute /usr/bin/hyprland ugyanazt csinálja. Egy szóközt tartalmazó nevet idézőjelezz, ahogy az omarchy crash mute 'Some App' esetében. Minden más továbbra is értesít, és a lenémított program továbbra is összeomlik - ez az emlékeztetőt rejti el, nem javít meg semmit.
Asztali alkalmazások
A Telepítés > AI menü néhány grafikus AI-alkalmazást is tartalmaz: a ChatGPT asztali alkalmazást, a Claude asztali alkalmazást (az Anthropic Linux bétáját, Chat, Cowork és Claude Code lapokkal), a Grok Botot az xAI modelljeivel való csevegéshez, a Hermes Desktopot, az OpenClaw-t, a Perplexity asztali alkalmazást és a T3 Code-ot. A Grok Bot az asztali csevegőalkalmazás. A kódoló ügynök a grok parancs.
A Hermes Desktop az, amelyikről tudnod kell, mert egy gépen egy Hermes van, és az az alkalmazásé: a Hermes kizárólag az alkalmazáson keresztül települ, és a hermes parancs, amelyet az alapértelmezett ügynök futtat, az alkalmazásé. A Hermes alapértelmezett ügynökként való kiválasztása ugyanazt telepíti, mint a Telepítés > AI bejegyzés: a csomagot, és egy ~/.hermes alatti Hermes runtime-ot, amelyet a Hermes saját telepítője állít be, és amely első alkalommal néhány percet vesz igénybe. Ez a runtime az az egyetlen Hermes, amelyet a terminálos hermes parancs, az alapértelmezett ügynök és az alkalmazás mind használnak, és a hermes update paranccsal frissíti magát, ahelyett, hogy egy Omarchy kiadásra várna. A telepítése átadja a Hermesnek az Omarchy témát omarchy nevű skinként is, amelyet minden Hermes-felület követ, ahogy témát váltasz; ha inkább ne tegye, válassz másikat a Hermes Appearance beállításai alatt vagy a /skin paranccsal, és az Omarchy azt a választást békén hagyja. Az alkalmazás Eltávolítás > AI alatti eltávolítása előbb bezárja a Hermest, a gatewayt is beleértve, magával viszi ezt a runtime-ot, és megtartja a csevegéseidet, emlékeidet és azokat a skilleket, amelyeket a Hermes magának írt, hacsak másként nem rendelkezel: megkérdezi, alapértelmezetten nemmel, hogy az adatok és a kapcsolati beállításaid is menjenek-e.
Az OpenClaw asztali élménye a Control UI-ja, amely webalkalmazásként nyílik meg, saját helyi gatewaye mögött. Az OpenClaw a ~/.openclaw könyvtárban él, és magát frissíti: használd a Control UI “Update Gateway” gombját, vagy futtasd az openclaw update parancsot, és a gateway az új verzión indul újra. Az Omarchy csak azt a kiadást választja ki, amelyikkel egy friss telepítés indul. Az OpenClaw Eltávolítás > AI alatti eltávolítása magával viszi a gateway szolgáltatást és az alkalmazást, majd megkérdezi, hogy a ~/.openclaw is menjen-e, mivel az a csevegéseidet és hitelesítő adataidat tartja az OpenClaw mellett és az általa letöltött plugin runtime-ok mellett; az alapértelmezés megtartja, és az OpenClaw újratelepítése újra felveszi.
A T3 Code a hivatalos AppImage kiadásából fut a ~/.local/share/t3code könyvtárban, nem egy csomagból, ezért magát frissíti. A telepítése megkérdezi, hogy a Stable vagy a Nightly csatornán szeretnél-e indulni; később a T3 Code beállításaiban válthatsz. A szálaid és beállításaid a ~/.t3 könyvtárban élnek, és a T3 Code Eltávolítás > AI alatti eltávolítása magával viszi őket.
Helyi LLM-ek
Az Omarchy két módot ajánl helyi LLM modellek futtatására: az LM Studiót és az Ollamát. Az LM Studio grafikus felületet biztosít nyílt súlyú modellek megtalálásához, telepítéséhez és futtatásához. Remek módja, hogy könnyen belevágj. Az Ollama CLI-t kínál ugyanehhez hasonló módon. De ha új vagy a helyi modellekben, én az LM Studióval kezdenék. Bármelyiket telepítheted az Omarchy Menu Telepítés > AI pontja alatt.
Az Omarchy Skill
Az ügynök skillek segítenek az AI-nak konkrét eszközöket konkrét módon használni, és az Omarchy egy alapértelmezett skillt szállít a rendszer testreszabásához. Például a Hyprland konfigurációd finomhangolásához, a sáv beállításához, vagy akár egy új téma nulláról való létrehozásához. Be van linkelve szimbolikusan a Claude Code (~/.claude/skills), a Codex (~/.codex/skills), a Pi (~/.pi/agent/skills), az Antigravity (~/.gemini/config/skills), a Hermes (~/.hermes/skills és minden ~/.hermes/profiles/*/skills), valamint az általános ~/.agents/skills hely skillkönyvtáraiba, így a legtöbb harness automatikusan felveszi.
De ezt a skillt kísérletiként kell kezelned. A különböző modellek különböző hatékonysággal fogják használni. A legjobb először plan módban futtatni, hogy legyen elképzelésed arról, mit szeretne az ügynök megváltoztatni. Aztán állj készen a változtatások visszavonására, vagy akár az omarchy reinstall configs meghívására, ha az ügynök mindent összezavar.