Ugrás a tartalomra
Chapters
  1. Üdv az Omarchyban!
  2. Első lépések
  3. Ha Macről vagy Windowsról jössz
  4. Navigáció
  5. A felső sáv
  6. Témák
  7. Gyorsbillentyűk
  8. Egységes vágólap és előzmények
  9. Emlékeztetők
  10. Értesítések
  11. Szövegkinyerés és diktálás
  12. Képernyőképek és rögzítés
  13. Kapcsolók, tétlenség és a képernyővédő
  14. Omarchy CLI
  15. Terminál
  16. Neovim
  17. AI
  18. Fejlesztői eszközök
  19. Shell-eszközök
  20. Shell-funkciók
  21. TUIs
  22. GUI-k
  23. Böngészők
  24. Kereskedelmi alkalmazások/szolgáltatások
  25. Webalkalmazások
  26. Játékok
  27. PDF-ek kitöltése
  28. Windows VM
  29. Egyéb csomagok
  30. Frissítések
  31. Dotfile-ok
  32. Shell-bővítmények
  33. Monitorok
  34. Billentyűzet, egér, érintőpad
  35. Hálózat
  36. Rendszeralvás
  37. Hardveres hitelesítés
  38. Betűtípusok
  39. Hátterek
  40. Prompt
  41. Arculat
  42. Gyakori finomhangolások
  43. Saját téma készítése
  44. Mac-támogatás
  45. Hibaelhárítás
  46. GYIK
  47. Rendszer-pillanatképek
  48. Biztonság
  49. Omarchy ezen: ...
  50. Telepítés kettős rendszerindítással
  51. Felügyelet nélküli telepítések

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.