Preskočiť na obsah
Chapters
  1. Vitajte v Omarchy!
  2. Začíname
  3. Prechod z Macu alebo Windowsu
  4. Navigácia
  5. Horný panel
  6. Témy
  7. Klávesové skratky
  8. Jednotná schránka a história
  9. Pripomienky
  10. Oznámenia
  11. Extrakcia textu a diktovanie
  12. Snímky obrazovky a nahrávanie
  13. Prepínače, nečinnosť a šetrič obrazovky
  14. Omarchy CLI
  15. Terminál
  16. Neovim
  17. AI
  18. Vývojárske nástroje
  19. Shell nástroje
  20. Shell funkcie
  21. TUIs
  22. Grafické rozhrania
  23. Prehliadače
  24. Komerčné aplikácie/služby
  25. Webové aplikácie
  26. Hranie hier
  27. Vypĺňanie PDF
  28. Virtuálny stroj s Windowsom
  29. Ostatné balíčky
  30. Aktualizácie
  31. Dotfiles
  32. Pluginy shellu
  33. Monitory
  34. Klávesnica, myš, trackpad
  35. Sieť
  36. Spánok systému
  37. Hardvérová autentifikácia
  38. Písma
  39. Pozadia
  40. Výzva príkazového riadka
  41. Branding
  42. Bežné úpravy
  43. Vytvorenie vlastnej témy
  44. Podpora pre Mac
  45. Riešenie problémov
  46. Časté otázky
  47. Systémové snímky
  48. Bezpečnosť
  49. Omarchy na...
  50. Inštalácia Dual Boot
  51. Bezobslužné inštalácie

Manuál

AI

Omarchy obsahuje spúšťače pre nižšie uvedených kódovacích agentov bez toho, aby za vás vybral predvoleného. Spustením príkazu sa pri prvom použití nainštaluje jeho CLI a potom sa na výzvu overíte. Hermes je výnimka: pri prvom použití sa preň nič neinštaluje a jeho výber nainštaluje Hermes Desktop, ako vysvetľuje časť Desktopové aplikácie nižšie.

Príkaz 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 Cognition
dsh DeepSeek Harness
freebuff Freebuff, bezplatný kódovací agent od Codebuff podporovaný reklamami
grok Grok Build od xAI
hermes Hermes, agent od Nous Research
kilo Kilo, kódovací agent založený na OpenCode
kimi Kimi Code
kiro-cli Kiro CLI
mcode MiniMax Code, kódovací agent od MiniMax
muse Muse Code, kódovací agent od Meta
omp Oh My Pi
ori Ori, harness od OpenRouter
pi Pi od Maria Zechnera
qwen Qwen Code, kódovací agent od Alibaba

ori je zvláštny prípad: spúšťa ostatné harnessy proti celému katalógu modelov OpenRouter, takže ori claude, ori codex alebo ori opencode spustia týchto agentov na akomkoľvek modeli, na ktorý ich nasmerujete, a ori code je vlastný agent Ori.

Inštalácia a aktualizácia agentov

Okrem Hermes títo agenti používajú lenivú inštaláciu cez mise: prvé spustenie nainštaluje CLI a neskoršie spustenia ho znova použijú. mise tiež najviac raz za štyri hodiny skontroluje, či pre nainštalovaného agenta nie je k dispozícii nová verzia, tesne pred jeho spustením alebo na pozadí pri výzve shellu. Ak táto aktualizácia zlyhá alebo ste offline, spustí sa nainštalovaná verzia. omarchy update aktualizuje nainštalovaných agentov spolu so zvyškom Omarchy a mup aktualizuje len nástroje spravované cez mise.

Vlastný aktualizátor agenta, napríklad claude update, codex update alebo tlačidlo aktualizácie v aplikácii, neaktualizuje inštaláciu spravovanú cez mise. codex update zlyhá a claude update môže hlásiť úspech, pričom nainštaluje samostatnú kópiu, ktorú mise nesleduje. Ak radšej chcete používať natívny inštalátor a aktualizátor agenta, pridajte ho do disable_tools; pozri Predinštalované CLI nástroje.

Ak chcete nainštalovať všetky nakonfigurované lenivé nástroje skôr, než ich budete potrebovať, spustite mise install --include-lazy. Patria sem aj ostatné predvolené CLI nástroje Omarchy, ako aj agenti. Informácie o inštalácii jedného nástroja alebo o použití vlastnej inštalácie nájdete v časti Predinštalované CLI nástroje.

grok sa inštaluje prostredníctvom vlastného balíka grok od mise, rovnakým spôsobom ako claude a codex. Spustite grok alebo ho vyberte v časti Setup > Defaults > Agent. Preskočte inštalátor curl | bash na x.ai. Táto cesta umiestni druhú kópiu do ~/.grok/bin, pridá ju na začiatok PATH a prepíše wrapper od Omarchy.

dsh otvorí svoje prehliadačové UI na 127.0.0.1:3080, pričom adresár spustenia je jeho predvoleným pracovným priestorom. Jeho prehliadačové UI neprijíma žiadny úvodný prompt, takže omarchy agent prompt ho otvorí s promptom vo vašej schránke, aby ste ho mohli prilepiť. Omarchy ho spúšťa s predvoľbou povolení bez schvaľovania od DeepSeek. DeepSeek Harness odovzdáva protokoly relácií spoločnosti DeepSeek, keď používate jej oficiálne API modelov; vypnite to v jeho prehliadačovom UI v časti Settings > General > Upload Session Log. Spätná väzba, ktorú mu pošlete, sa tiež odovzdá spolu s reláciou, pokiaľ ho nespustíte s DSH_TELEMETRY_MODE=DISABLED.

Predvolený agent

Vyberte si predvoleného agenta pomocou omarchy default agent <name> alebo v časti Setup > Defaults > Agent v Omarchy Menu (Super + Space). Ak agent ešte nie je nainštalovaný, jeho výber ho najprv nainštaluje. Čerstvé Omarchy vás k tomuto výberu vyzve jednorazovým upozornením.

Výber Claude sa tiež pokúsi nastaviť jeho rozšírenie prehliadača pre Chromium, Chrome, Brave, Brave Origin a Edge. Nastavenie rozšírenia sa vzťahuje na všetkých používateľov a môže si vyžiadať vaše systémové heslo; zrušenie alebo neúspešná inštalácia rozšírenia aj tak vyberie a spustí Claude. Reštartujte prehliadač, v prípade výzvy povoľte rozšírenie a prihláste sa do Claude, aby ste dokončili jeho pripojenie. Pripojenie skontrolujete spustením /chrome v Claude. Firefox a Zen toto rozšírenie nepodporujú. Ak už Claude bol vaším predvoleným agentom pred pridaním tohto nastavenia, vyberte ho znova, aby sa rozšírenie nainštalovalo.

Keď ste si vybrali, Super + Shift + Ctrl + A spustí predvoleného agenta vo vyhradenom okne terminálu (alebo zobrazí výber, ak ste si ešte nevybrali). Môžete ho tiež spustiť priamo do úlohy pomocou omarchy agent prompt "Review this project". Freebuff a DeepSeek Harness neprijímajú žiadny úvodný prompt, takže sa namiesto toho otvoria s promptom vo vašej schránke, aby ste ho mohli prilepiť. Takto spustení agenti bežia bez dozoru vo svojich príslušných režimoch, v ktorých sa nezastavujú, aby sa pýtali, takže buďte pripravení na to, že budú skutočne niečo robiť! MiniMax Code takýto režim pre svoje interaktívne relácie nemá, takže žiada o povolenia ako zvyčajne. A keďže agenti odmietajú zapamätať si dôveru pre váš domovský adresár, spustenia z $HOME namiesto toho začínajú v ~/Work.

Existujú aj skratky v termináli: a spustí predvoleného agenta priamo v aktuálnom termináli, zatiaľ čo c, cx a cy spustia priamo OpenCode, Claude Code a Codex (opäť v ich režimoch automatického schvaľovania). Zmeny témy sa tiež synchronizujú do agentov: Claude Code, Pi, OpenCode a Hermes (keď ho Omarchy nainštaluje) všetci nasledujú, keď prepnete tému Omarchy.

Panel agentov

V hornom paneli je ikona agentov. Skôr než si nastavíte agenta, jeho panel vás prevedie prihlásením do Claude, Codex alebo Grok a prvý z nich sa stane vaším predvoleným agentom. Potom panel umiestni každé predplatné na jednu stránku: každého agenta a účet s jeho plánom, ukazovateľ pre každý z jeho 5-hodinových limitov relácie a týždenných limitov s časom do jeho resetovania (presné percento zobrazíte podržaním kurzora), alebo zostávajúci predplatený zostatok, pod riadkom, ktorý sa striedavo mení tým, čo ste použili naprieč všetkými, napríklad tokeny za tento týždeň a váš najpoužívanejší model. V časti Make something ponúka úvodné prompty pre novú tému, plugin alebo aplikáciu, ktoré odovzdajú úlohu vášmu predvolenému agentovi. Aplikácie sa vytvárajú rovnakým spôsobom ako vlastné Hype, Monologue a Omacut od Omarchy, v C++ a Qt Quick, podľa skillu agenta omarchy-app a kompilátor a časti Qt, ktoré potrebujú, sú nainštalované. Claude Code, Codex, Grok, Kimi, Cursor a jeho kvóta Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi a Devin sú pokryté hneď po vybalení so svojimi limitmi a Hermes, Mistral Vibe a Qwen Code zobrazia svoje relácie a tokeny, keď ich použijete. Zobrazia sa aj plány poskytovateľov a kľúče, ktoré používate prostredníctvom pi, omp alebo opencode: OpenCode Zen a Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan a Synthetic so svojimi limitmi; Fireworks, OpenRouter a DeepSeek so svojimi predplatenými zostatkami; a modely, ktoré prevádzkujete na vlastnom hardvéri v časti Local models. Každý agent sa počíta raz, pod tým, kto ho účtuje, bez ohľadu na to, cez koľko harnessov ho prevádzkujete.

Kliknite ľavým tlačidlom na ikonu v paneli pre panel, kliknite pravým tlačidlom na spustenie predvoleného agenta. Záznamy o používaní, ktoré za ním stoja, sa regenerujú každých 15 minút pomocou omarchy agent usage-update a panel môže dokonca zlúčiť používanie z vašich ostatných počítačov prostredníctvom synchronizovaného priečinka. Úplné nastavenia nájdete v README v časti $OMARCHY_PATH/shell/plugins/agents/.

Viacero predplatných

Ak platíte za viac než jeden plán Claude, Codex alebo Grok - napríklad osobný Max a pracovný - Omarchy ich môže ponechať všetky prihlásené a presúvať sa medzi nimi. Pridajte predplatné pomocou + v paneli agentov, ktorý vás tým prevedie priamo tam, alebo pomocou omarchy agent account add claude Work (alebo codex, alebo grok). Ak chýba, nainštaluje CLI. Prvý účet pre poskytovateľa sa prihlási prostredníctvom vášho bežného prehliadača, presne tam, kde to CLI vždy hľadá. Každý ďalší sa potom prihlási prostredníctvom súkromného okna, aby sa omylom nevybral účet, do ktorého je váš prehliadač už prihlásený; prihláste sa tam ako účet, ktorý pridávate, a najprv zatvorte všetky súkromné okná, ktoré už máte otvorené. Na to sa nikdy neodhlasujte z CLI: odhlásenie zruší uložené prihlásenie a daný účet by bolo potrebné pridať znova.

Ak chcete skopírovať prihlásenia predplatného do iného počítača s Omarchy cez SSH, spustite omarchy agent account copy user@laptop. Odosielateľ poskytne dočasný prijímač, keď cieľový počítač žiadny nainštalovaný nemá, takže staršie počítače s Omarchy môžu prijímať účty bez aktualizácie. Nainštalované prijímače majú prednosť. Týmto sa skopírujú všetky predplatné Claude, Codex a Grok; pridajte názvy poskytovateľov, aby ste ich vybrali, ako v omarchy agent account copy laptop claude. Názvy účtov a ID príkazov zodpovedajú zdroju, vrátane účtov, ktoré už sú na cieľovom počítači prítomné. Nesúvisiace cieľové účty dostanú číselnú príponu, ak ich názvy kolidujú, a nastavenia, skilly, pluginy a história konverzácií zostanú lokálne na každom počítači.

Existujúce cieľové prihlasovacie údaje sa zachovajú. Zdrojový účet, ktorý je tam už prihlásený, má svoj názov synchronizovaný bez nahradenia jeho prihlasovacích údajov; ostatné účty sa pridajú popri ňom. Ak chcete nahradiť uložené prihlasovacie údaje pre zodpovedajúce účty, použite omarchy agent account copy --replace laptop claude po ukončení relácií daného účtu na cieľovom počítači. Čerstvý cieľový počítač tiež dostane aktívny účet a predvoľby prepínania zdroja; zavedený cieľový počítač si ponechá svoje vlastné.

Prihlasovacie údaje cestujú cez SSH a sú uložené v súkromných súboroch na cieľovom počítači, takže kopírujte len do počítačov, ktorým dôverujete. Ide o jednorazové kopírovanie, nie o priebežnú synchronizáciu. Obnovovacie tokeny Codex môže iný počítač otáčať, čo ponechá skopírované prihlásenie v stave, keď potrebuje obnovenie; samostatné prihlásenia zostávajú najspoľahlivejšou voľbou pre súčasné používanie na viacerých počítačoch. Pozri návod Codexu na overovanie účtov.

Jeden účet na poskytovateľa je aktívny a každá nová relácia začína ako on: cx, cy, obyčajné claude, codex alebo grok, čokoľvek spustené prostredníctvom omarchy agent a skripty alebo editory, ktoré nájdu CLI na PATH. Prepnite pomocou omarchy agent account use work (a späť pomocou omarchy agent account use main) alebo v paneli stlačením čísla účtu a potom Enter (alebo kliknutím na jeho tlačidlo Use). Relácie, ktoré už bežia, zostanú na účte, s ktorým začali. História konverzácií, nastavenia, skilly a pluginy sú zdieľané medzi účtami, takže claude --continue v rovnakom priečinku pokračuje tam, kde ste na novom účte skončili.

Pri viac než jednom účte panel zobrazuje limity každého účtu vedľa seba, pričom aktívny je označený. Omarchy vás predvolene upozorní, keď aktívny účet prekročí 95 % limitu, a kliknutie na upozornenie prepne na účet s najväčšou rezervou. Podržte kurzor nad riadkom účtu v paneli a kliknite na Autoswitch, ktoré sa zobrazí vedľa Use (alebo stlačte m), alebo spustite omarchy agent account mode auto, aby sa namiesto toho prepínal sám; kým je zapnutý, Autoswitch zaujme miesto Use a jeho opätovné kliknutie sa vráti k upozorňovaniu. Pridajte číslo, aby ste zmenili prah, ako v omarchy agent account mode auto 90. Ak je každý účet nad prahom, dozviete sa o tom raz, spolu s tým, ktorý účet sa uvoľní ako prvý. Kým je aktívny účet do 15 bodov od svojho prahu (80 % pri predvolenom nastavení), jeho limity sa kontrolujú každé tri minúty namiesto každých 15.

omarchy agent account list zobrazí každý účet a jeho najnovšie limity, omarchy agent account remove work zabudne jeden a omarchy agent account rename primary Hey premenuje jeden (alebo kliknite na názov účtu v paneli). Tieto príkazy fungujú na účtoch vášho predvoleného agenta; ak chcete dosiahnuť druhého poskytovateľa, najprv ho pomenujte, ako v omarchy agent account use codex side. Prihlásenie, ktoré ste už mali v ~/.claude alebo ~/.codex, je účet Main a zostáva tam, kde je. Účet ponechaný bez použitia viac než približne osem hodín môže zobraziť Sign-in required; kliknite naň, aby ste daný účet znova prihlásili priamo v paneli, alebo v ňom spustite reláciu, ktorá prihlásenie obnoví sama. Servery MCP, ktoré ste mali, keď bol účet pridaný, s ním prídu, ale tie, ktoré pridáte neskôr pomocou claude mcp add, dosiahnu len účet, v ktorom ste ich pridali. Claude Desktop a nástroje nakonfigurované s absolútnou cestou k binárnemu súboru CLI prepnutie nenasledujú. Explicitné CLAUDE_CONFIG_DIR, CODEX_HOME alebo GROK_HOME má prednosť pred vybraným účtom.

Diagnostika pádov

Omarchy sleduje systemd-coredump kvôli pádom procesov. Keď niečo segfaultuje, dostanete upozornenie „Process crashed“ - kliknite naň a pád sa odovzdá vášmu predvolenému agentovi spolu so skillom diagnose-crash od Omarchy, ktorý prevedie agenta zisťovaním faktov z výpisu jadra a rozhodovaním, či pád stojí za to nahlásiť upstreamu. Môžete ho tiež spustiť ručne proti akémukoľvek PID z coredumpctl list pomocou omarchy agent crash <pid>.

Sledovanie je predvolene zapnuté. Vypnite ho v časti Trigger > Toggle > Crash Capture (alebo pomocou omarchy toggle crash-capture) a upozornenia prestanú; omarchy agent crash <pid> stále funguje ručne.

Pády možno tiež stíšiť jeden program po druhom, čo vám diagnostika ponúkne na konci. omarchy crash mute hyprland zastaví upozornenia len pre daný program, omarchy crash mute hyprland off ich vráti späť a omarchy crash mute samo o sebe vypíše, čo ste stíšili. Berie cestu binárneho súboru rovnako ochotne ako jeho názov, takže omarchy crash mute /usr/bin/hyprland robí to isté. Názov s medzerou uveďte v úvodzovkách, ako v omarchy crash mute 'Some App'. Všetko ostatné stále upozorňuje a stíšený program stále padá - toto skrýva pripomienku, nič to neopravuje.

Desktopové aplikácie

Ponuka Install > AI tiež obsahuje niekoľko grafických AI aplikácií: desktopovú aplikáciu ChatGPT, desktopovú aplikáciu Claude (Linux beta od Anthropic s kartami Chat, Cowork a Claude Code), Grok Bot na chatovanie s modelmi xAI, Hermes Desktop, OpenClaw, desktopovú aplikáciu Perplexity a T3 Code. Grok Bot je desktopová chatovacia aplikácia. Kódovací agent je príkaz grok.

Hermes Desktop je ten, o ktorom treba vedieť, pretože počítač má jeden Hermes a ten patrí aplikácii: Hermes sa inštaluje len prostredníctvom aplikácie a príkaz hermes, ktorý predvolený agent spúšťa, patrí aplikácii. Výber Hermes ako predvoleného agenta nainštaluje to isté, čo položka Install > AI: balík a runtime Hermes pod ~/.hermes nastavený vlastným inštalátorom Hermes, čo prvýkrát trvá niekoľko minút. Tento runtime je ten jediný Hermes, ktorý používajú terminálový príkaz hermes, predvolený agent aj aplikácia, a aktualizuje sa sám pomocou hermes update, namiesto čakania na vydanie Omarchy. Jeho inštalácia tiež odovzdá Hermes tému Omarchy ako skin s názvom omarchy, ktorý každý povrch Hermes nasleduje, keď prepínate témy; vyberte si iný v nastaveniach Appearance v Hermes alebo pomocou /skin, ak by ste radšej, aby to nerobil, a Omarchy túto voľbu ponechá na pokoji. Odstránenie aplikácie v časti Remove > AI najprv zatvorí Hermes vrátane gateway, vezme so sebou tento runtime a ponechá vaše chaty, spomienky a skilly, ktoré si Hermes sám pre seba napísal, pokiaľ mu nepoviete inak: opýta sa, s predvolenou odpoveďou nie, či majú odísť aj tieto údaje a vaše nastavenia pripojenia.

Desktopovým zážitkom OpenClaw je jeho Control UI, ktoré sa otvára ako webová aplikácia podporovaná jeho vlastnou lokálnou gateway. OpenClaw žije v ~/.openclaw a aktualizuje sa sám: použite tlačidlo „Update Gateway“ v Control UI alebo spustite openclaw update a gateway sa reštartuje na novej verzii. Omarchy vyberá len vydanie, od ktorého čerstvá inštalácia začína. Odstránenie OpenClaw v časti Remove > AI vezme so sebou službu gateway a aplikáciu a potom sa opýta, či má odísť aj ~/.openclaw, keďže ten uchováva vaše chaty a prihlasovacie údaje spolu so samotným OpenClaw a runtime pluginov, ktoré sťahuje; predvolene ho ponechá a opätovná inštalácia OpenClaw ho znova prevezme.

T3 Code beží zo svojho oficiálneho vydania AppImage v ~/.local/share/t3code namiesto z balíka, takže sa aktualizuje sám. Pri jeho inštalácii sa opýta, či chcete začať na kanáli Stable alebo Nightly; neskôr prepnite v nastaveniach T3 Code. Vaše vlákna a nastavenia žijú v ~/.t3 a odstránenie T3 Code v časti Remove > AI ich vezme so sebou.

Lokálne LLM

Omarchy odporúča dva spôsoby prevádzkovania lokálnych modelov LLM: LM Studio a Ollama. LM Studio poskytuje GUI rozhranie na vyhľadávanie modelov s otvorenými váhami, ich inštaláciu a spúšťanie. Je to skvelý spôsob, ako ľahko začať. Ollama ponúka CLI na podobné robenie toho istého. Ale ak ste v lokálnych modeloch noví, ja by som začal s LM Studio. Obe môžete nainštalovať v časti Install > AI v Omarchy Menu.

Skill Omarchy

Skilly agentov pomáhajú AI používať konkrétne nástroje konkrétnym spôsobom a Omarchy sa dodáva s predvoleným skillom na prispôsobenie systému. Ako napríklad ladenie vašej konfigurácie Hyprland, úprava panela alebo dokonca vytvorenie novej témy od nuly. Je symlinkovaný do adresárov skillov pre Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills a každý ~/.hermes/profiles/*/skills) a všeobecné umiestnenie ~/.agents/skills, takže ho väčšina harnessov prevezme automaticky.

Tento skill by ste však mali považovať za experimentálny. Rôzne modely ho použijú s rôznym účinkom. Najlepšie je najprv bežať v režime plánovania, aby ste mali predstavu o tom, čo by agent chcel zmeniť. A potom buďte pripravení vrátiť zmeny späť alebo dokonca spustiť omarchy reinstall configs, ak agent všetko pokazí.