Manual
AI
Omarchy include lansatoare pentru agenții de programare de mai jos, fără să aleagă unul implicit pentru tine. Rulează o comandă pentru a-i instala CLI-ul la prima utilizare, apoi autentifică-te când ți se cere. Hermes este excepția: nu se instalează nimic pentru el la prima utilizare, iar alegerea lui instalează Hermes Desktop, așa cum explică mai jos secțiunea Aplicații desktop.
| Comandă | 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 de la Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, agentul de programare gratuit și susținut prin reclame al Codebuff |
grok |
Grok Build de la xAI |
hermes |
Hermes, agentul Nous Research |
kilo |
Kilo, un agent de programare bazat pe OpenCode |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, agentul de programare al MiniMax |
muse |
Muse Code, agentul de programare al Meta |
omp |
Oh My Pi |
ori |
Ori, harness-ul OpenRouter |
pi |
Pi al lui Mario Zechner |
qwen |
Qwen Code, agentul de programare al Alibaba |
ori este cel diferit: rulează celelalte harness-uri pe întregul catalog de modele al OpenRouter, așa că ori claude, ori codex sau ori opencode pornesc acei agenți pe orice model le indici, iar ori code este propriul agent al Ori.
Instalarea și actualizarea agenților
Cu excepția lui Hermes, acești agenți folosesc instalarea leneșă a mise: prima lansare instalează CLI-ul, iar lansările ulterioare îl reutilizează. mise verifică, de asemenea, dacă un agent instalat are o versiune nouă cel mult o dată la patru ore, chiar înainte să pornească sau în fundal, la un prompt de shell. Dacă actualizarea respectivă eșuează sau ești offline, rulează versiunea instalată. omarchy update actualizează agenții instalați împreună cu restul Omarchy, iar mup actualizează doar instrumentele gestionate de mise.
Propriul program de actualizare al unui agent, cum ar fi claude update, codex update sau un buton de actualizare dintr-o aplicație, nu actualizează instalarea gestionată de mise. codex update eșuează, iar claude update poate raporta succes în timp ce instalează o copie separată pe care mise nu o urmărește. Dacă preferi să folosești programul de instalare și de actualizare nativ al unui agent, adaugă-l în disable_tools; vezi Instrumente CLI preinstalate.
Pentru a instala toate instrumentele leneșe configurate înainte să ai nevoie de ele, rulează mise install --include-lazy. Aceasta include și celelalte instrumente CLI implicite ale Omarchy, pe lângă agenți. Vezi Instrumente CLI preinstalate pentru instalarea unui singur instrument sau pentru folosirea propriei tale instalări.
grok este instalat prin pachetul first-party grok al mise, la fel ca claude și codex. Rulează grok sau alege-l sub Setup > Defaults > Agent. Sari peste programul de instalare curl | bash de pe x.ai. Acea cale pune o a doua copie în ~/.grok/bin, o pune la începutul PATH și suprascrie wrapper-ul Omarchy.
dsh își deschide interfața de browser pe 127.0.0.1:3080, cu directorul de lansare drept spațiu de lucru implicit. Interfața sa de browser nu acceptă un prompt de pornire, așa că omarchy agent prompt o deschide cu promptul în clipboard, ca să-l lipești. Omarchy o pornește cu presetarea de permisiuni fără aprobare a DeepSeek. DeepSeek Harness încarcă jurnalele de sesiune către DeepSeek când folosești API-ul său oficial de modele; oprește asta sub Settings > General > Upload Session Log în interfața sa de browser. Feedbackul pe care i-l trimiți este încărcat și el împreună cu sesiunea, cu excepția cazului în care îl pornești cu DSH_TELEMETRY_MODE=DISABLED.
Agentul implicit
Alege-ți agentul implicit cu omarchy default agent <name> sau sub Setup > Defaults > Agent în Meniul Omarchy (Super + Space). Dacă agentul nu este încă instalat, alegerea lui îl instalează mai întâi. Un Omarchy proaspăt te va invita să faci această alegere printr-o notificare unică.
Alegerea lui Claude încearcă, de asemenea, să configureze extensia sa de browser pentru Chromium, Chrome, Brave, Brave Origin și Edge. Configurarea extensiei se aplică tuturor utilizatorilor și îți poate cere parola de sistem; anularea sau o instalare eșuată a extensiei tot selectează și lansează Claude. Repornește browserul, activează extensia dacă ți se cere și conectează-te la Claude pentru a finaliza conectarea acesteia. Rulează /chrome în Claude pentru a verifica conexiunea. Firefox și Zen nu acceptă această extensie. Dacă Claude era deja agentul tău implicit înainte de adăugarea acestei configurări, selectează-l din nou pentru a instala extensia.
Odată ce ai ales, Super + Shift + Ctrl + A lansează agentul implicit într-o fereastră de terminal dedicată (sau afișează selectorul dacă nu ai ales încă unul). Îl poți lansa și direct într-o sarcină cu omarchy agent prompt "Review this project". Freebuff și DeepSeek Harness nu acceptă un prompt de pornire, așa că ele se deschid în schimb cu promptul în clipboard, ca să-l lipești. Agenții lansați astfel rulează nesupravegheați în modurile lor respective de tipul „nu te opri să întrebi”, așa că fii pregătit ca ei chiar să facă lucruri! MiniMax Code nu are un astfel de mod pentru sesiunile sale interactive, așa că cere permisiuni ca de obicei. Și, cum agenții refuză să rețină încrederea pentru directorul tău personal, lansările din $HOME pornesc în schimb în ~/Work.
Există și scurtături de terminal: a rulează agentul implicit inline în terminalul curent, în timp ce c, cx și cy pornesc direct OpenCode, Claude Code și Codex (tot în modurile lor cu aprobare automată). Și schimbările de temă se sincronizează cu agenții: Claude Code, Pi, OpenCode și Hermes (odată ce Omarchy l-a instalat) te urmează cu toții când schimbi tema Omarchy.
Panoul de agenți
Bara de sus are o pictogramă pentru agenți. Înainte să fi configurat un agent, panoul său te ghidează prin conectarea la Claude, Codex sau Grok, iar primul devine agentul tău implicit. După aceea, panoul pune fiecare abonament pe o singură pagină: fiecare agent și cont cu planul său, un indicator pentru fiecare dintre limitele sale de sesiune de 5 ore și săptămânale, cu timpul rămas până la resetare (treci cu mouse-ul peste el pentru procentul exact), sau soldul preplătit rămas, sub o linie care rotește prin ce ai folosit la toți, cum ar fi tokenurile din această săptămână și modelul tău cel mai folosit. Sub Make something oferă prompturi de pornire pentru o temă, un plugin sau o aplicație nouă, care predau sarcina agentului tău implicit. Aplicațiile sunt construite așa cum sunt construite Hype, Monologue și Omacut ale Omarchy, în C++ și Qt Quick, urmând skill-ul de agent omarchy-app, iar compilatorul și componentele Qt de care au nevoie vin instalate. Claude Code, Codex, Grok, Kimi, Cursor și alocația sa Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi și Devin sunt acoperite din start cu limitele lor, iar Hermes, Mistral Vibe și Qwen Code își afișează sesiunile și tokenurile odată ce le-ai folosit. Și planurile și cheile de furnizori pe care le folosești prin pi, omp sau opencode apar: OpenCode Zen și Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan și Synthetic, cu limitele lor; Fireworks, OpenRouter și DeepSeek, cu soldurile lor preplătite; și modelele pe care le rulezi pe propriul tău hardware, sub Local models. Fiecare agent este numărat o singură dată, sub cine îl facturează, indiferent prin câte harness-uri îl conduci.
Dă clic stânga pe pictograma din bară pentru panou, clic dreapta pentru a lansa agentul tău implicit. Înregistrările de utilizare din spatele lui sunt regenerate la fiecare 15 minute de omarchy agent usage-update, iar panoul poate chiar să îmbine utilizarea de pe celelalte mașini ale tale printr-un folder sincronizat. Vezi README-ul sub $OMARCHY_PATH/shell/plugins/agents/ pentru setările complete.
Mai multe abonamente
Dacă plătești pentru mai mult de un plan Claude, Codex sau Grok - unul personal Max și unul de serviciu, să zicem - Omarchy le poate păstra pe toate conectate și poate trece de la unul la altul. Adaugă un abonament cu + în panoul de agenți, care te ghidează chiar acolo, sau cu omarchy agent account add claude Work (sau codex, sau grok). Instalează CLI-ul dacă lipsește. Primul cont pentru un furnizor se conectează prin browserul tău normal, exact unde caută CLI-ul întotdeauna. Fiecare cont după aceea se conectează printr-o fereastră privată, așa că contul la care browserul tău este deja conectat nu este preluat din greșeală; conectează-te acolo ca acel cont pe care îl adaugi și închide mai întâi orice fereastră privată pe care o aveai deja deschisă. Nu te deconecta niciodată din CLI pentru a face asta: deconectarea revocă conectarea salvată, iar acel cont ar trebui adăugat din nou.
Pentru a copia conectările la abonamentele tale pe o altă mașină Omarchy prin SSH, rulează omarchy agent account copy user@laptop. Expeditorul furnizează un receptor temporar atunci când destinația nu are unul instalat, așa că mașinile Omarchy mai vechi pot primi conturi fără o actualizare. Receptorii instalați au prioritate. Aceasta copiază toate abonamentele Claude, Codex și Grok; adaugă numele furnizorilor pentru a le selecta, ca în omarchy agent account copy laptop claude. Numele conturilor și ID-urile comenzilor corespund sursei, inclusiv conturile deja prezente la destinație. Conturile de destinație fără legătură primesc un sufix numeric dacă numele lor intră în conflict, iar setările, skill-urile, pluginurile și istoricul conversațiilor rămân locale fiecărei mașini.
Acreditările existente la destinație sunt păstrate. Un cont sursă deja conectat acolo își are numele sincronizat fără a-i înlocui acreditările; celelalte conturi sunt adăugate alături. Pentru a înlocui acreditările salvate pentru conturile corespunzătoare, folosește omarchy agent account copy --replace laptop claude după ce ai închis sesiunile acelui cont la destinație. O destinație proaspătă primește și contul activ al sursei și preferințele sale de comutare; o destinație deja stabilită le păstrează pe ale ei.
Acreditările călătoresc prin SSH și sunt stocate în fișiere private la destinație, așa că copiază doar pe mașini în care ai încredere. Aceasta este o copie unică, nu o sincronizare continuă. Tokenurile de reîmprospătare Codex pot fi rotite de o altă mașină, lăsând o conectare copiată cu nevoie de reînnoire; conectările separate rămân cea mai fiabilă alegere pentru utilizarea simultană pe mai multe mașini. Vezi ghidul de autentificare a conturilor al Codex.
Un singur cont per furnizor este activ, iar fiecare sesiune nouă începe ca el: cx, cy, un simplu claude, codex sau grok, orice lansat prin omarchy agent și scripturile sau editoarele care găsesc CLI-ul în PATH. Comută cu omarchy agent account use work (și înapoi cu omarchy agent account use main) sau în panou, apăsând numărul unui cont și apoi Enter (sau dând clic pe butonul său Use). Sesiunile care rulează deja rămân pe contul cu care au pornit. Istoricul conversațiilor, setările, skill-urile și pluginurile sunt partajate între conturi, așa că claude --continue în același folder continuă de unde ai rămas pe noul cont.
Cu mai mult de un cont, panoul arată limitele fiecărui cont una lângă alta, cu cel activ marcat. În mod implicit, Omarchy te notifică atunci când contul activ depășește 95% dintr-o limită, iar darea unui clic pe notificare comută la contul cu cel mai mult spațiu liber. Treci cu mouse-ul peste linia unui cont în panou și dă clic pe Autoswitch care apare lângă Use (sau apasă m), sau rulează omarchy agent account mode auto, pentru ca el să comute singur în schimb; cât timp este activat, Autoswitch ia locul lui Use, iar darea unui clic pe el din nou revine la notificare. Adaugă un număr pentru a schimba pragul, ca în omarchy agent account mode auto 90. Dacă fiecare cont depășește pragul, vei afla despre asta o singură dată, împreună cu ce cont se eliberează primul. Cât timp un cont activ se află la cel mult 15 puncte de pragul său (80% la valoarea implicită), limitele sale sunt verificate la fiecare trei minute, nu la fiecare 15.
omarchy agent account list arată fiecare cont și cele mai recente limite ale sale, omarchy agent account remove work uită unul, iar omarchy agent account rename primary Hey redenumește unul (sau dă clic pe numele unui cont în panou). Aceste comenzi funcționează pe conturile agentului tău implicit; pentru a ajunge la celălalt furnizor, numește-l mai întâi, ca în omarchy agent account use codex side. Conectarea pe care o aveai deja în ~/.claude sau ~/.codex este contul Main și rămâne unde este. Un cont nefolosit mai mult de aproximativ opt ore poate afișa Sign-in required; dă clic pe el pentru a conecta din nou acel cont chiar în panou sau pornește o sesiune în el, ceea ce reîmprospătează conectarea de la sine. Serverele MCP pe care le aveai atunci când a fost adăugat un cont vin împreună cu el, dar cele pe care le adaugi mai târziu cu claude mcp add ajung doar în contul în care le-ai adăugat. Claude Desktop și instrumentele configurate cu o cale absolută către un binar CLI nu urmează comutarea. Un CLAUDE_CONFIG_DIR, CODEX_HOME sau GROK_HOME explicit are prioritate față de contul selectat.
Diagnosticarea căderilor
Omarchy urmărește systemd-coredump pentru căderi de procese. Când ceva face segfault, vei primi o notificare „Process crashed” - dă clic pe ea, iar căderea este predată agentului tău implicit împreună cu skill-ul diagnose-crash al Omarchy, care ghidează agentul prin stabilirea faptelor din core dump și prin decizia dacă acea cădere merită raportată în amonte. O poți rula și manual pe orice PID din coredumpctl list cu omarchy agent crash <pid>.
Supravegherea este activată în mod implicit. Oprește-o sub Trigger > Toggle > Crash Capture (sau cu omarchy toggle crash-capture) și notificările se opresc; omarchy agent crash <pid> tot funcționează manual.
Căderile pot fi, de asemenea, reduse la tăcere câte un program pe rând, ceea ce diagnosticarea îți oferă la sfârșit. omarchy crash mute hyprland oprește notificările doar pentru acel program, omarchy crash mute hyprland off le aduce înapoi, iar omarchy crash mute singur listează ce ai redus la tăcere. Acceptă la fel de bucuros calea binarului ca numele său, așa că omarchy crash mute /usr/bin/hyprland face același lucru. Pune între ghilimele un nume cu spațiu în el, ca în omarchy crash mute 'Some App'. Orice altceva tot notifică, iar programul redus la tăcere tot cade - asta ascunde mementoul, nu repară nimic.
Aplicații desktop
Meniul Install > AI include și câteva aplicații AI grafice: aplicația desktop ChatGPT, aplicația desktop Claude (beta-ul Linux al Anthropic, cu filele Chat, Cowork și Claude Code), Grok Bot pentru discuții cu modelele xAI, Hermes Desktop, OpenClaw, aplicația desktop Perplexity și T3 Code. Grok Bot este aplicația desktop de chat. Agentul de programare este comanda grok.
Hermes Desktop este cel despre care trebuie să știi, pentru că o mașină are un singur Hermes, iar acesta este al aplicației: Hermes este instalat întotdeauna doar prin aplicație, iar comanda hermes pe care o rulează agentul implicit este a aplicației. Alegerea lui Hermes ca agent implicit instalează același lucru pe care îl face intrarea Install > AI: pachetul și un runtime Hermes sub ~/.hermes configurat de propriul program de instalare al Hermes, ceea ce durează câteva minute prima dată. Acel runtime este singurul Hermes pe care îl folosesc comanda hermes din terminal, agentul implicit și aplicația, și se actualizează singur cu hermes update, în loc să aștepte o versiune Omarchy. Instalarea lui îi dă, de asemenea, lui Hermes tema Omarchy ca skin numit omarchy, pe care fiecare suprafață Hermes o urmează pe măsură ce schimbi temele; alege alta sub setările Appearance ale Hermes sau cu /skin dacă preferi să nu o facă, iar Omarchy lasă acea alegere în pace. Eliminarea aplicației sub Remove > AI închide mai întâi Hermes, gateway-ul inclus, ia acel runtime cu ea și îți păstrează discuțiile, memoriile și skill-urile pe care Hermes le-a scris pentru sine, cu excepția cazului în care îi spui altfel: te întreabă, cu nu ca valoare implicită, dacă și acele date și setările tale de conexiune ar trebui să dispară.
Experiența desktop a OpenClaw este Control UI a sa, care se deschide ca aplicație web susținută de propriul său gateway local. OpenClaw trăiește în ~/.openclaw și se actualizează singur: folosește butonul „Update Gateway” din Control UI sau rulează openclaw update, iar gateway-ul repornește pe noua versiune. Omarchy alege doar versiunea de la care pornește o instalare proaspătă. Eliminarea OpenClaw sub Remove > AI ia serviciul gateway și aplicația cu ea și apoi întreabă dacă ar trebui să dispară și ~/.openclaw, deoarece acela păstrează discuțiile și acreditările tale alături de OpenClaw însuși și de runtime-urile de plugin pe care le descarcă; valoarea implicită îl păstrează, iar instalarea din nou a OpenClaw îl preia înapoi.
T3 Code rulează din versiunea sa oficială AppImage în ~/.local/share/t3code, nu dintr-un pachet, așa că se actualizează singur. Instalarea lui te întreabă dacă să pornească pe canalul Stable sau Nightly; comută mai târziu în setările T3 Code. Firele și setările tale trăiesc în ~/.t3, iar eliminarea T3 Code sub Remove > AI le ia cu ea.
LLM-uri locale
Omarchy recomandă două moduri de a rula modele LLM locale: LM Studio și Ollama. LM Studio oferă o interfață GUI pentru găsirea modelelor cu greutăți deschise, instalarea lor și rularea lor. Este o modalitate excelentă de a porni ușor. Ollama oferă un CLI pentru a face același lucru în mod similar. Dar dacă ești nou în materie de modele locale, eu aș începe cu LM Studio. Le poți instala pe oricare sub Install > AI în Meniul Omarchy.
Skill-ul Omarchy
Skill-urile de agent ajută AI-ul să folosească instrumente specifice într-un mod specific, iar Omarchy vine cu un skill implicit pentru adaptarea sistemului. Cum ar fi ajustarea configurației tale Hyprland, reglarea barei sau chiar crearea unei teme noi de la zero. Este legat simbolic în directoarele de skill-uri pentru Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills și fiecare ~/.hermes/profiles/*/skills) și locația generică ~/.agents/skills, așa că majoritatea harness-urilor îl preiau automat.
Dar ar trebui să tratezi acest skill ca experimental. Modele diferite îl vor folosi cu efecte diferite. Cel mai bine este să rulezi mai întâi în modul plan, ca să ai o idee despre ce ar vrea agentul să schimbe. Și apoi fii pregătit să anulezi schimbările sau chiar să invoci omarchy reinstall configs, dacă agentul face harcea-parcea din tot.