Manuál
AI
Omarchy zahrnuje spouštěče pro níže uvedené kódovací agenty, aniž by za vás vybíral výchozího. Příkaz při prvním použití nainstaluje své CLI a poté vás vyzve k ověření. Hermes je výjimka: při prvním použití se pro něj nic neinstaluje a jeho výběrem se nainstaluje Hermes Desktop, jak vysvětluje část Desktopové aplikace níže.
| Pří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ý reklamou |
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 Mario Zechnera |
qwen |
Qwen Code, kódovací agent od Alibaba |
ori je ten zvláštní: spouští ostatní harnessy proti celému katalogu modelů OpenRouter, takže ori claude, ori codex nebo ori opencode spustí tyto agenty na libovolném modelu, na který je namíříte, a ori code je vlastní agent Ori.
Instalace a aktualizace agentů
S výjimkou Hermes používají tito agenti línou instalaci přes mise: první spuštění nainstaluje CLI a další spuštění ho znovu použijí. mise také nejvýše jednou za čtyři hodiny zkontroluje, zda pro nainstalovaného agenta nevyšla nová verze, těsně před jeho spuštěním nebo na pozadí při zobrazení promptu shellu. Pokud tato aktualizace selže nebo jste offline, spustí se nainstalovaná verze. omarchy update aktualizuje nainstalované agenty spolu se zbytkem Omarchy a mup aktualizuje pouze nástroje spravované přes mise.
Vlastní aktualizátor agenta, například claude update, codex update nebo tlačítko aktualizace v aplikaci, neaktualizuje instalaci spravovanou přes mise. codex update selže a claude update může nahlásit úspěch, přičemž nainstaluje samostatnou kopii, kterou mise nesleduje. Pokud byste raději používali nativní instalátor a aktualizátor agenta, přidejte ho do disable_tools; viz Předinstalované nástroje CLI.
Chcete-li nainstalovat všechny nakonfigurované líné nástroje dříve, než je budete potřebovat, spusťte mise install --include-lazy. To zahrnuje i ostatní výchozí nástroje CLI Omarchy, stejně jako agenty. Informace o instalaci jednoho nástroje nebo použití vlastní instalace najdete v části Předinstalované nástroje CLI.
grok se instaluje prostřednictvím vlastního balíčku grok od mise, stejně jako claude a codex. Spusťte grok nebo ho vyberte v části Nastavení > Výchozí > Agent. Přeskočte instalátor curl | bash na x.ai. Tato cesta umístí druhou kopii do ~/.grok/bin, přidá ji na začátek PATH a přepíše wrapper Omarchy.
dsh otevře své prohlížečové UI na 127.0.0.1:3080, přičemž adresář spuštění je jeho výchozím pracovním prostorem. Jeho prohlížečové UI nepřijímá žádný počáteční prompt, takže omarchy agent prompt ho otevře s promptem ve schránce k vložení. Omarchy ho spouští s předvolbou oprávnění bez schvalování od DeepSeek. DeepSeek Harness nahrává protokoly relací do DeepSeek, když používáte jeho oficiální API modelů; vypněte to v jeho prohlížečovém UI v části Settings > General > Upload Session Log. Zpětná vazba, kterou mu odešlete, se také nahrává spolu s relací, pokud ho nespustíte s DSH_TELEMETRY_MODE=DISABLED.
Výchozí agent
Vyberte si výchozího agenta pomocí omarchy default agent <name> nebo v části Nastavení > Výchozí > Agent v Omarchy Menu (Super + Space). Pokud agent ještě není nainstalován, jeho výběrem se nejprve nainstaluje. Čerstvá instalace Omarchy vás k této volbě vyzve jednorázovým oznámením.
Výběr Claude se také pokusí nastavit jeho rozšíření prohlížeče pro Chromium, Chrome, Brave, Brave Origin a Edge. Nastavení rozšíření se vztahuje na všechny uživatele a může vyžadovat vaše systémové heslo; zrušení nebo neúspěšná instalace rozšíření přesto vybere a spustí Claude. Restartujte prohlížeč, v případě výzvy povolte rozšíření a přihlaste se do Claude, abyste dokončili jeho připojení. Spuštěním /chrome v Claude zkontrolujete připojení. Firefox a Zen toto rozšíření nepodporují. Pokud byl Claude vaším výchozím agentem už před přidáním tohoto nastavení, vyberte ho znovu, abyste rozšíření nainstalovali.
Jakmile si vyberete, Super + Shift + Ctrl + A spustí výchozího agenta ve vyhrazeném okně terminálu (nebo zobrazí výběr, pokud jste si ještě nevybrali). Můžete ho také spustit rovnou do úkolu pomocí omarchy agent prompt "Review this project". Freebuff a DeepSeek Harness nepřijímají žádný počáteční prompt, takže se místo toho otevřou s promptem ve schránce k vložení. Takto spuštění agenti běží bez dohledu ve svých příslušných režimech, kdy se nezastavují, aby se zeptali, takže buďte připraveni, že budou skutečně něco dělat! MiniMax Code takový režim pro své interaktivní relace nemá, takže žádá o oprávnění jako obvykle. A protože agenti odmítají zapamatovat si důvěru pro váš domovský adresář, spuštění z $HOME místo toho začínají v ~/Work.
Existují i zkratky v terminálu: a spustí výchozího agenta přímo v aktuálním terminálu, zatímco c, cx a cy spustí přímo OpenCode, Claude Code a Codex (opět v jejich režimech automatického schvalování). Změny motivu se synchronizují i do agentů: Claude Code, Pi, OpenCode a Hermes (jakmile ho Omarchy nainstaluje) se všechny přizpůsobí, když přepnete motiv Omarchy.
Panel agentů
Horní lišta má ikonu agentů. Než si agenta nastavíte, její panel vás provede přihlášením do Claude, Codex nebo Grok a první z nich se stane vaším výchozím agentem. Poté panel umístí každé předplatné na jednu stránku: každého agenta a účet s jeho plánem, ukazatel pro každý z jeho 5hodinových limitů relace a týdenních limitů s časem do resetování (přesnou procentní hodnotu zobrazíte najetím), nebo zbývající předplacený zůstatek, pod řádkem, který střídá to, co jste u všech spotřebovali, například tokeny za tento týden a váš nejpoužívanější model. V části Vytvořte něco nabízí úvodní prompty pro nový motiv, plugin nebo aplikaci, které předají úkol vašemu výchozímu agentovi. Aplikace se vytvářejí tak, jak se vytvářejí vlastní aplikace Omarchy Hype, Monologue a Omacut, v C++ a Qt Quick, podle dovednosti agenta omarchy-app, a kompilátor a součásti Qt, které potřebují, jsou nainstalovány. Claude Code, Codex, Grok, Kimi, Cursor a jeho příděl Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi a Devin jsou pokryty hned po instalaci i se svými limity a Hermes, Mistral Vibe a Qwen Code zobrazí své relace a tokeny, jakmile je použijete. Objeví se i plány poskytovatelů a klíče, které používáte prostřednictvím pi, omp nebo opencode: OpenCode Zen a Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan a Synthetic se svými limity; Fireworks, OpenRouter a DeepSeek se svými předplacenými zůstatky; a modely, které spouštíte na vlastním hardwaru, v části Lokální modely. Každý agent se započítává jednou, u toho, kdo ho fakturuje, bez ohledu na to, přes kolik harnessů ho ovládáte.
Kliknutím levým tlačítkem na ikonu na liště zobrazíte panel, kliknutím pravým tlačítkem spustíte výchozího agenta. Záznamy o využití, na nichž panel stojí, každých 15 minut znovu generuje omarchy agent usage-update a panel dokonce dokáže sloučit využití z vašich ostatních počítačů prostřednictvím synchronizované složky. Úplné nastavení najdete v souboru README v adresáři $OMARCHY_PATH/shell/plugins/agents/.
Více předplatných
Pokud platíte za více než jeden plán Claude, Codex nebo Grok - řekněme osobní Max a pracovní - Omarchy je může udržet všechny přihlášené a přepínat mezi nimi. Přidejte předplatné pomocí + v panelu agentů, který vás tím provede přímo tam, nebo pomocí omarchy agent account add claude Work (nebo codex, nebo grok). Pokud CLI chybí, nainstaluje ho. První účet pro poskytovatele se přihlašuje prostřednictvím vašeho běžného prohlížeče, přesně tam, kde to CLI vždy hledá. Každý další se přihlašuje prostřednictvím soukromého okna, takže účet, ke kterému je váš prohlížeč už přihlášen, nebude omylem vybrán; přihlaste se tam jako účet, který přidáváte, a nejprve zavřete všechna soukromá okna, která už máte otevřená. Nikdy se kvůli tomu neodhlasujte z CLI: odhlášení zruší uložené přihlášení a tento účet by bylo nutné přidat znovu.
Chcete-li zkopírovat přihlášení k předplatným do jiného počítače s Omarchy přes SSH, spusťte omarchy agent account copy user@laptop. Odesílatel poskytne dočasného příjemce, když cílový počítač žádného nainstalovaného nemá, takže starší počítače s Omarchy mohou přijímat účty bez aktualizace. Nainstalovaní příjemci mají přednost. To zkopíruje všechna předplatná Claude, Codex a Grok; přidejte názvy poskytovatelů, abyste je vybrali, například omarchy agent account copy laptop claude. Názvy účtů a ID příkazů odpovídají zdroji, včetně účtů, které už na cílovém počítači existují. Nesouvisející cílové účty dostanou číselnou příponu, pokud se jejich názvy střetnou, a nastavení, dovednosti, pluginy a historie konverzací zůstávají lokální na každém počítači.
Stávající cílové přihlašovací údaje se zachovají. Zdrojový účet, který je tam už přihlášen, má synchronizovaný název, aniž by se nahradily jeho přihlašovací údaje; ostatní účty se přidají vedle něj. Chcete-li nahradit uložené přihlašovací údaje pro odpovídající účty, použijte omarchy agent account copy --replace laptop claude poté, co na cílovém počítači ukončíte relace daného účtu. Čerstvý cílový počítač také získá aktivní účet zdroje a jeho předvolby přepínání; zavedený cílový počítač si ponechá své vlastní.
Přihlašovací údaje putují přes SSH a ukládají se do soukromých souborů na cílovém počítači, takže kopírujte pouze na počítače, kterým důvěřujete. Jde o jednorázovou kopii, nikoli o průběžnou synchronizaci. Obnovovací tokeny Codex může jiný počítač rotovat, takže zkopírované přihlášení bude potřebovat obnovení; samostatná přihlášení zůstávají nejspolehlivější volbou pro současné použití na několika počítačích. Viz Pokyny Codexu k ověřování účtů.
Jeden účet na poskytovatele je aktivní a každá nová relace začíná jako on: cx, cy, prosté claude, codex nebo grok, cokoli spuštěné prostřednictvím omarchy agent a skripty nebo editory, které najdou CLI na PATH. Přepněte pomocí omarchy agent account use work (a zpět pomocí omarchy agent account use main), nebo v panelu stisknutím čísla účtu a poté Enter (nebo kliknutím na jeho tlačítko Use). Relace, které už běží, zůstanou na účtu, se kterým začaly. Historie konverzací, nastavení, dovednosti a pluginy se sdílejí mezi účty, takže claude --continue ve stejné složce naváže tam, kde jste na novém účtu skončili.
Při více než jednom účtu panel zobrazuje limity každého účtu vedle sebe, přičemž aktivní je označen. Ve výchozím nastavení vás Omarchy upozorní, když aktivní účet překročí 95 % limitu, a kliknutím na oznámení přepnete na účet s největší rezervou. Najeďte na řádek účtu v panelu a klikněte na Autoswitch, které se objeví vedle Use (nebo stiskněte m), nebo spusťte omarchy agent account mode auto, aby místo toho přepínal sám; když je zapnuté, Autoswitch zaujme místo Use a dalším kliknutím se vrátíte k oznamování. Přidejte číslo, abyste změnili práh, například omarchy agent account mode auto 90. Pokud je každý účet nad prahem, dozvíte se o tom jednou, spolu s tím, který účet se uvolní jako první. Zatímco je aktivní účet do 15 bodů od svého prahu (80 % ve výchozím nastavení), jeho limity se kontrolují každé tři minuty místo každých 15.
omarchy agent account list zobrazí každý účet a jeho nejnovější limity, omarchy agent account remove work jeden zapomene a omarchy agent account rename primary Hey jeden přejmenuje (nebo klikněte na název účtu v panelu). Tyto příkazy pracují s účty vašeho výchozího agenta; chcete-li dosáhnout na jiného poskytovatele, nejprve ho pojmenujte, například omarchy agent account use codex side. Přihlášení, které už jste měli v ~/.claude nebo ~/.codex, je účet Main a zůstává tam, kde je. Účet, který se nepoužívá déle než zhruba osm hodin, může zobrazovat Sign-in required; kliknutím na něj se k danému účtu znovu přihlásíte přímo v panelu, nebo v něm spusťte relaci, která přihlášení obnoví sama. Servery MCP, které jste měli, když byl účet přidán, s ním přijdou, ale ty, které přidáte později pomocí claude mcp add, se dostanou pouze k účtu, ve kterém jste je přidali. Claude Desktop a nástroje nakonfigurované s absolutní cestou k binárnímu souboru CLI přepnutí nenásledují. Výslovné CLAUDE_CONFIG_DIR, CODEX_HOME nebo GROK_HOME má přednost před vybraným účtem.
Diagnostika pádů
Omarchy sleduje systemd-coredump kvůli pádům procesů. Když něco segfaultuje, dostanete oznámení „Process crashed“ - klikněte na něj a pád bude předán vašemu výchozímu agentovi spolu s dovedností diagnose-crash od Omarchy, která agenta provede zjištěním faktů z výpisu paměti a rozhodnutím, zda pád stojí za nahlášení upstreamu. Můžete ji také spustit ručně proti libovolnému PID z coredumpctl list pomocí omarchy agent crash <pid>.
Sledování je ve výchozím nastavení zapnuté. Vypněte ho v části Trigger > Toggle > Crash Capture (nebo pomocí omarchy toggle crash-capture) a oznámení přestanou; omarchy agent crash <pid> stále funguje ručně.
Pády lze také ztlumit po jednotlivých programech, což vám diagnostika na konci nabídne. omarchy crash mute hyprland zastaví oznámení pouze pro daný program, omarchy crash mute hyprland off je vrátí zpět a samotné omarchy crash mute vypíše, co jste ztlumili. Přijímá cestu k binárnímu souboru stejně ochotně jako jeho název, takže omarchy crash mute /usr/bin/hyprland udělá totéž. Název s mezerou dejte do uvozovek, například omarchy crash mute 'Some App'. Všechno ostatní stále oznamuje a ztlumený program stále padá - to skrývá připomenutí, nic to nespravuje.
Desktopové aplikace
Nabídka Install > AI obsahuje také několik grafických aplikací AI: desktopovou aplikaci ChatGPT, desktopovou aplikaci Claude (Linux beta od Anthropic, s kartami Chat, Cowork a Claude Code), Grok Bot pro chatování s modely xAI, Hermes Desktop, OpenClaw, desktopovou aplikaci Perplexity a T3 Code. Grok Bot je desktopová chatovací aplikace. Kódovací agent je příkaz grok.
Hermes Desktop je ta, o které je dobré vědět, protože počítač má jeden Hermes a ten patří aplikaci: Hermes se instaluje pouze prostřednictvím aplikace a příkaz hermes, který výchozí agent spouští, je ten od aplikace. Výběr Hermes jako výchozího agenta nainstaluje totéž, co položka Install > AI: balíček a runtime Hermes v ~/.hermes nastavený vlastním instalátorem Hermes, což poprvé trvá několik minut. Tento runtime je ten jediný Hermes, který používají terminálový příkaz hermes, výchozí agent i aplikace, a aktualizuje se sám pomocí hermes update, místo aby čekal na vydání Omarchy. Jeho instalace také předá Hermes motiv Omarchy jako skin s názvem omarchy, který každé rozhraní Hermes následuje, když přepínáte motivy; vyberte si jiný v nastavení Appearance v Hermes nebo pomocí /skin, pokud to raději nechcete, a Omarchy tuto volbu nechá být. Odebrání aplikace v části Remove > AI nejprve zavře Hermes, včetně gateway, vezme s sebou tento runtime a zachová vaše chaty, vzpomínky a dovednosti, které si Hermes sám napsal, pokud neřeknete jinak: zeptá se, přičemž výchozí odpověď je ne, zda mají odejít i tato data a vaše nastavení připojení.
Desktopovým zážitkem OpenClaw je jeho Control UI, které se otevírá jako webová aplikace podporovaná vlastní lokální gateway. OpenClaw žije v ~/.openclaw a aktualizuje se sám: použijte tlačítko „Update Gateway“ v Control UI nebo spusťte openclaw update a gateway se restartuje na nové verzi. Omarchy vybírá pouze vydání, od kterého čerstvá instalace začíná. Odebrání OpenClaw v části Remove > AI s sebou vezme službu gateway a aplikaci a poté se zeptá, zda má odejít i ~/.openclaw, protože to obsahuje vaše chaty a přihlašovací údaje vedle samotného OpenClaw a runtime pluginů, které stahuje; výchozí nastavení ho zachovává a opětovná instalace OpenClaw ho znovu převezme.
T3 Code běží ze svého oficiálního vydání AppImage v ~/.local/share/t3code, nikoli z balíčku, takže se aktualizuje sám. Jeho instalace se zeptá, zda chcete začít na kanálu Stable nebo Nightly; později to přepnete v nastavení T3 Code. Vaše vlákna a nastavení žijí v ~/.t3 a odebrání T3 Code v části Remove > AI je vezme s sebou.
Lokální LLM
Omarchy doporučuje dva způsoby spouštění lokálních modelů LLM: LM Studio a Ollama. LM Studio poskytuje GUI rozhraní pro vyhledávání modelů s otevřenými váhami, jejich instalaci a spouštění. Je to skvělý způsob, jak snadno začít. Ollama nabízí CLI, které to dělá podobně. Ale pokud s lokálními modely začínáte, začal bych s LM Studio. Obojí můžete nainstalovat v části Install > AI v Omarchy Menu.
Skill Omarchy
Dovednosti agentů pomáhají AI používat konkrétní nástroje konkrétním způsobem a Omarchy dodává výchozí dovednost pro přizpůsobení systému. Jako je úprava konfigurace Hyprland, úprava lišty nebo dokonce vytvoření nového motivu od nuly. Je nalinkována symbolickými odkazy do adresářů dovedností pro 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 obecné umístění ~/.agents/skills, takže ji většina harnessů převezme automaticky.
Tuto dovednost byste ale měli považovat za experimentální. Různé modely ji využijí s různým účinkem. Nejlepší je nejprve běžet v režimu plánování, abyste měli představu, co by agent rád změnil. A pak buďte připraveni vrátit změny zpět, nebo dokonce vyvolat omarchy reinstall configs, pokud agent všechno zpřehází.