Käsiraamat
AI
Omarchy sisaldab alltoodud kodeerimisagentide käivitajaid, ilma et valiks sulle vaikimisi ühte. Käivita käsk, et selle CLI esmakordsel kasutamisel installida, seejärel autentige, kui seda küsitakse. Hermes on erand: selle jaoks ei installita esmakordsel kasutamisel midagi ja selle valimine installib Hermes Desktopi, nagu allpool jaotis Töölauarakendused selgitab.
| Käsk | 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 ettevõttelt Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuffi tasuta, reklaamitoega kodeerimisagent |
grok |
Grok Build ettevõttelt xAI |
hermes |
Hermes, Nous Researchi agent |
kilo |
Kilo, OpenCode’il põhinev kodeerimisagent |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMaxi kodeerimisagent |
muse |
Muse Code, Meta kodeerimisagent |
omp |
Oh My Pi |
ori |
Ori, OpenRouteri harness |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code, Alibaba kodeerimisagent |
ori on erandlik: see käitab teisi harness’eid OpenRouteri kogu mudelikataloogi vastu, nii et ori claude, ori codex või ori opencode käivitavad need agendid ükskõik millisel mudelil, millele sa need suunad, ja ori code on Ori enda agent.
Agentide installimine ja värskendamine
Välja arvatud Hermes kasutavad need agendid mise laiska installimist: esimene käivitamine installib CLI ja hilisemad käivitamised kasutavad seda uuesti. Samuti kontrollib mise installitud agenti uue versiooni suhtes kõige rohkem kord iga nelja tunni järel, vahetult enne selle käivitamist või taustal shelli viiba juures. Kui see värskendus ebaõnnestub või oled võrguühenduseta, töötab installitud versioon. omarchy update värskendab installitud agente koos ülejäänud Omarchyga ja mup värskendab ainult mise hallatavaid tööriistu.
Agendi enda värskendaja, näiteks claude update, codex update või rakenduses olev värskendamisnupp, ei värskenda mise hallatavat installi. codex update ebaõnnestub ja claude update võib teatada õnnestumisest, installides samal ajal eraldi koopia, mida mise ei jälgi. Kui eelistad selle asemel kasutada agendi oma installijat ja värskendajat, lisa see loendisse disable_tools; vaata Eelinstallitud CLI-tööriistad.
Kõigi konfigureeritud laiskade tööriistade installimiseks enne, kui neid vajad, käivita mise install --include-lazy. See hõlmab lisaks agentidele ka Omarchy teisi vaikimisi CLI-tööriistu. Üksiku tööriista installimise või oma installi kasutamise kohta vaata Eelinstallitud CLI-tööriistad.
grok installitakse mise ametliku grok paketi kaudu, samamoodi nagu claude ja codex. Käivita grok või vali see jaotises Setup > Defaults > Agent. Jäta x.ai saidil olev curl | bash installija vahele. See tee paneb teise koopia kausta ~/.grok/bin, lisab selle PATH algusesse ja kirjutab Omarchy wrapperi üle.
dsh avab oma brauseri kasutajaliidese aadressil 127.0.0.1:3080, kusjuures käivituskataloog on selle vaikimisi tööruum. Selle brauseri kasutajaliides ei võta vastu algusviipa, nii et omarchy agent prompt avab selle koos viibaga sinu lõikelaual, et saaksid selle kleepida. Omarchy käivitab selle DeepSeeki kinnitust mittevajava õiguste eelseadistusega. DeepSeek Harness laadib seansilogid DeepSeeki üles, kui kasutad selle ametlikku mudeli API-t; lülita see välja selle brauseri kasutajaliideses jaotises Settings > General > Upload Session Log. Tagasiside, mille sa sellele saadad, laaditakse samuti koos seansiga üles, välja arvatud juhul, kui käivitad selle valikuga DSH_TELEMETRY_MODE=DISABLED.
Vaikeagent
Vali oma vaikeagent käsuga omarchy default agent <name> või Omarchy menüüs (Super + Space) jaotises Setup > Defaults > Agent. Kui agent ei ole veel installitud, installib selle valimine selle kõigepealt. Värske Omarchy kutsub sind seda valikut tegema ühekordse teavitusega.
Claude’i valimine üritab seadistada ka selle brauserilaienduse Chromiumi, Chrome’i, Brave’i, Brave Origini ja Edge’i jaoks. Laienduse seadistamine kehtib kõigile kasutajatele ja võib küsida sinu süsteemiparooli; laienduse installimise tühistamine või ebaõnnestumine valib ja käivitab Claude’i ikkagi. Taaskäivita brauser, luba laiendus, kui seda küsitakse, ja selle ühendamise lõpetamiseks logi Claude’i sisse. Ühenduse kontrollimiseks käivita Claude’is /chrome. Firefox ja Zen seda laiendust ei toeta. Kui Claude oli sinu vaikeagent juba enne selle seadistuse lisamist, vali see laienduse installimiseks uuesti.
Kui oled valiku teinud, käivitab Super + Shift + Ctrl + A vaikeagendi spetsiaalses terminaliaknas (või avab valija, kui sa ei ole veel valinud). Samuti saad selle käivitada otse ülesande juurde käsuga omarchy agent prompt "Review this project". Freebuff ja DeepSeek Harness ei võta algusviipa vastu, nii et need avanevad selle asemel koos viibaga sinu lõikelaual, et saaksid selle kleepida. Sel viisil käivitatud agendid töötavad järelevalveta oma vastavates küsimiseks-mittepeatumise režiimides, nii et ole valmis selleks, et nad tõesti asju teevad! MiniMax Code’il ei ole oma interaktiivsete seansside jaoks sellist režiimi, nii et see küsib õigusi nagu tavaliselt. Ja kuna agendid keelduvad sinu kodukataloogi usaldust meelde jätmast, algavad $HOME kaustast käivitamised hoopis kaustas ~/Work.
Samuti on olemas terminali otseteed: a käitab vaikeagenti samas terminalis, samas kui cx, cy - oota, c, cx ja cy käivitavad otse OpenCode’i, Claude Code’i ja Codexi (jällegi nende automaatse kinnitamise režiimides). Teemamuudatused sünkroonitakse ka agentidega: Claude Code, Pi, OpenCode ja Hermes (kui Omarchy on selle installinud) järgivad kõik kaasa, kui vahetad Omarchy teemat.
Agentide paneel
Ülemisel ribal on agentide ikoon. Enne agendi seadistamist juhatab selle paneel sind läbi Claude’i, Codexi või Groki sisselogimise ja esimesest saab sinu vaikeagent. Pärast seda koondab paneel iga tellimuse ühele lehele: iga agent ja konto koos selle plaaniga, iga selle 5-tunnise seansi ja nädalase limiidi mõõdik koos ajaga selle lähtestamiseni (täpse protsendi vaatamiseks hoia kursorit selle kohal) või järelejäänud ettemakstud saldo, rea all, mis vaheldub selle vahel, mida oled nende kõigi peale kokku kasutanud, nagu selle nädala tokenid ja sinu enim kasutatud mudel. Jaotises Make something pakub see uue teema, plugina või rakenduse jaoks algusviipasid, mis annavad ülesande sinu vaikeagendile. Rakendused ehitatakse samamoodi nagu Omarchy enda Hype, Monologue ja Omacut, C++ ja Qt Quickiga, järgides omarchy-app agendi skilli, ning nende jaoks vajalik kompilaator ja Qt osad on juba installitud. Claude Code, Codex, Grok, Kimi, Cursor ja selle Grok Boti maht, GitHub Copilot, Muse, Antigravity, Kimchi ja Devin on koos oma limiitidega kohe kaetud ning Hermes, Mistral Vibe ja Qwen Code näitavad oma seansse ja tokeneid, kui oled neid kasutanud. Samuti kuvatakse teenusepakkujate plaanid ja võtmed, mida kasutad pi, omp või opencode kaudu: OpenCode Zen ja Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan ja Synthetic koos oma limiitidega; Fireworks, OpenRouter ja DeepSeek koos oma ettemakstud saldodega; ning mudelid, mida käitad oma riistvaral jaotises Local models. Iga agenti loetakse üks kord, selle järgi, kes selle eest arve esitab, olenemata sellest, mitme harness’i kaudu sa seda juhid.
Paneeli avamiseks tee vasakklõps riba ikoonil, vaikeagendi käivitamiseks paremklõps. Selle taga olevaid kasutusandmeid genereerib iga 15 minuti järel uuesti omarchy agent usage-update ja paneel saab isegi sünkroonitud kausta kaudu ühendada kasutust sinu teistelt masinatelt. Täielike seadete kohta vaata README faili kaustas $OMARCHY_PATH/shell/plugins/agents/.
Mitu tellimust
Kui maksad rohkem kui ühe Claude’i, Codexi või Groki plaani eest - näiteks isiklik Max ja töö oma - saab Omarchy hoida need kõik sisse logituna ja nende vahel liikuda. Lisa tellimus agentide paneelis oleva + abil, mis juhatab sind sealsamas läbi protsessi, või käsuga omarchy agent account add claude Work (või codex või grok). See installib CLI, kui see puudub. Teenusepakkuja esimene konto logib sisse sinu tavalise brauseri kaudu, täpselt seal, kuhu CLI alati vaatab. Iga järgmine logib sisse privaatse akna kaudu, nii et kontot, kuhu sinu brauser on juba sisse logitud, kogemata ei valita; logi seal sisse kontona, mida lisad, ja sulge kõigepealt iga privaatne aken, mis sul juba avatud on. Ära selleks kunagi CLI-st välja logi: väljalogimine tühistab salvestatud sisselogimise ja see konto tuleks uuesti lisada.
Tellimuste sisselogimiste kopeerimiseks teise Omarchy masinasse SSH kaudu käivita omarchy agent account copy user@laptop. Saatja annab ajutise vastuvõtja, kui sihtkohal ei ole seda installitud, nii et vanemad Omarchy masinad saavad kontosid vastu võtta ilma värskenduseta. Installitud vastuvõtjad on ülimuslikud. See kopeerib kõik Claude’i, Codexi ja Groki tellimused; nende valimiseks lisa teenusepakkujate nimed, nagu käsus omarchy agent account copy laptop claude. Kontode nimed ja käskude ID-d vastavad allikale, sealhulgas kontod, mis on sihtkohas juba olemas. Omavahel mitteseotud sihtkoha kontod saavad nimekonflikti korral numbrijärelliite ning seaded, skillid, pluginad ja vestluste ajalugu jäävad iga masina jaoks kohalikuks.
Olemasolevad sihtkoha mandaadid säilitatakse. Allika konto, mis on sinna juba sisse logitud, nime sünkroonitakse ilma selle mandaate asendamata; teised kontod lisatakse selle kõrvale. Salvestatud mandaatide asendamiseks vastavate kontode puhul kasuta käsku omarchy agent account copy --replace laptop claude pärast selle konto seansside sulgemist sihtkohas. Värske sihtkoht saab ka allika aktiivse konto ja vahetamise eelistused; väljakujunenud sihtkoht säilitab enda omad.
Mandaadid liiguvad SSH kaudu ja neid hoitakse sihtkohas privaatsetes failides, nii et kopeeri ainult masinatesse, mida usaldad. See on ühekordne kopeerimine, mitte pidev sünkroonimine. Codexi värskendustokeneid võib teine masin roteerida, jättes kopeeritud sisselogimise uuendamist vajama; eraldi sisselogimised jäävad mitmel masinal samaaegseks kasutamiseks kõige usaldusväärsemaks valikuks. Vaata Codexi konto autentimise juhiseid.
Teenusepakkuja kohta on aktiivne üks konto ja iga uus seanss algab sellisena: cx, cy, tavaline claude, codex või grok, kõik, mis käivitatakse omarchy agent kaudu, ning skriptid või redaktorid, mis leiavad CLI PATH kaudu. Vaheta käsuga omarchy agent account use work (ja tagasi käsuga omarchy agent account use main) või paneelis, vajutades konto numbrit ja seejärel Enter (või klõpsates selle nuppu Use). Juba töötavad seansid jäävad kontole, millega need algasid. Vestluste ajalugu, seaded, skillid ja pluginad jagatakse kontode vahel, nii et claude --continue samas kaustas jätkab samast kohast, kus uuel kontol pooleli jäid.
Rohkem kui ühe konto korral näitab paneel iga konto limiite kõrvuti, aktiivne on tähistatud. Vaikimisi teavitab Omarchy sind, kui aktiivne konto ületab 95% limiidist, ja teavituse klõpsamine lülitub kontole, millel on kõige rohkem vaba ruumi. Hoia kursorit paneelis konto rea kohal ja klõpsa nupu Use kõrvale ilmuvat valikut Autoswitch (või vajuta m) või käivita omarchy agent account mode auto, et see vahetaks selle asemel ise; kui see on sisse lülitatud, asendab Autoswitch nuppu Use ja selle uuesti klõpsamine läheb tagasi teavitamisele. Läve muutmiseks lisa number, nagu käsus omarchy agent account mode auto 90. Kui iga konto on läve ületanud, kuuled sellest üks kord koos sellega, milline konto esimesena vabaneb. Kui aktiivne konto on oma lävest 15 punkti raames (vaikimisi 80%), kontrollitakse selle limiite iga kolme minuti järel, mitte iga 15 minuti järel.
omarchy agent account list näitab iga kontot ja selle uusimaid limiite, omarchy agent account remove work unustab ühe ja omarchy agent account rename primary Hey nimetab ühe ümber (või klõpsa paneelis konto nime). Need käsud töötavad sinu vaikeagendi kontodega; teise teenusepakkujani jõudmiseks nimeta see kõigepealt, nagu käsus omarchy agent account use codex side. Sisselogimine, mis sul juba kaustas ~/.claude või ~/.codex oli, on Main konto ja jääb sinna, kus see on. Konto, mida ei ole kasutatud rohkem kui umbes kaheksa tundi, võib näidata teadet Sign-in required; klõpsa seda, et see konto otse paneelis uuesti sisse logida, või käivita selles seanss, mis värskendab sisselogimist iseenesest. MCP serverid, mis sul konto lisamisel olid, tulevad sellega kaasa, kuid need, mille lisad hiljem käsuga claude mcp add, jõuavad ainult kontoni, kuhu need lisasid. Claude Desktop ja tööriistad, mis on konfigureeritud CLI binaarfaili absoluutse teega, vahetust ei järgi. Sõnaselge CLAUDE_CONFIG_DIR, CODEX_HOME või GROK_HOME on valitud kontost ülimuslik.
Krahhide diagnoosimine
Omarchy jälgib systemd-coredumpi protsesside krahhide suhtes. Kui midagi segfaultib, saad teavituse “Process crashed” - klõpsa seda ja krahh antakse koos Omarchy diagnose-crash skilliga sinu vaikeagendile, mis juhatab agenti core dumpist faktide kindlakstegemise ja selle otsustamise kaudu, kas krahhist tasub ülesvoolu teatada. Samuti saad selle käsitsi käivitada mis tahes PID vastu loendist coredumpctl list käsuga omarchy agent crash <pid>.
Jälgimine on vaikimisi sisse lülitatud. Lülita see välja jaotises Trigger > Toggle > Crash Capture (või käsuga omarchy toggle crash-capture) ja teavitused lakkavad; omarchy agent crash <pid> töötab endiselt käsitsi.
Krahhe saab vaigistada ka ühe programmi kaupa, mida diagnoos sulle lõpus pakub. omarchy crash mute hyprland peatab teavitused ainult selle programmi jaoks, omarchy crash mute hyprland off toob need tagasi ja omarchy crash mute üksinda loetleb, mida oled vaigistanud. See võtab binaarfaili tee sama meelsasti vastu kui selle nime, nii et omarchy crash mute /usr/bin/hyprland teeb sama asja. Pane tühikut sisaldav nimi jutumärkidesse, nagu käsus omarchy crash mute 'Some App'. Kõik muu teavitab endiselt ja vaigistatud programm krahhib endiselt - see peidab meeldetuletuse, see ei paranda midagi.
Töölauarakendused
Menüü Install > AI sisaldab ka mõnda graafilist AI-rakendust: ChatGPT töölauarakendus, Claude’i töölauarakendus (Anthropicu Linuxi beeta koos Chat, Cowork ja Claude Code vahelehtedega), Grok Bot xAI mudelitega vestlemiseks, Hermes Desktop, OpenClaw, Perplexity töölauarakendus ja T3 Code. Grok Bot on töölaua vestlusrakendus. Kodeerimisagent on käsk grok.
Hermes Desktop on see, mida tasub teada, sest masinal on üks Hermes ja see kuulub rakendusele: Hermes installitakse ainult rakenduse kaudu ja käsk hermes, mida vaikeagent käitab, on rakenduse oma. Hermes’i vaikeagendiks valimine installib sama asja, mida teeb kirje Install > AI: paketi ja Hermese runtime’i kaustas ~/.hermes, mille seadistab Hermese enda installija, mis võtab esimesel korral paar minutit. See runtime on ainus Hermes, mida terminali käsk hermes, vaikeagent ja rakendus kõik kasutavad, ning see värskendab ennast käsuga hermes update, selle asemel et oodata Omarchy väljalaset. Selle installimine annab Hermesele ka Omarchy teema skinina nimega omarchy, mida iga Hermese pind teemade vahetamisel järgib; vali Hermese Appearance seadetes või käsuga /skin mõni muu, kui eelistad, et see nii ei oleks, ja Omarchy jätab selle valiku rahule. Rakenduse eemaldamine jaotises Remove > AI sulgeb kõigepealt Hermese, sealhulgas gateway, võtab selle runtime’i endaga kaasa ja säilitab sinu vestlused, mälud ja skillid, mille Hermes endale kirjutas, välja arvatud juhul, kui ütled sellele teisiti: see küsib, vaikimisi eitavalt, kas ka need andmed ja sinu ühenduse seaded peaksid kaduma.
OpenClaw töölauakogemus on selle Control UI, mis avaneb veebirakendusena, mida toetab selle enda kohalik gateway. OpenClaw asub kaustas ~/.openclaw ja värskendab ennast: kasuta Control UI nuppu “Update Gateway” või käivita openclaw update ja gateway taaskäivitub uuel versioonil. Omarchy valib ainult selle, millisest väljalaskest värske install algab. OpenClaw eemaldamine jaotises Remove > AI võtab gateway teenuse ja rakenduse endaga kaasa ning küsib seejärel, kas ka ~/.openclaw peaks kaduma, kuna see hoiab sinu vestlusi ja mandaate koos OpenClaw enda ja selle allalaaditavate pluginate runtime’idega; vaikimisi säilitatakse see ja OpenClaw uuesti installimine võtab selle tagasi kasutusele.
T3 Code töötab oma ametlikust AppImage väljalaskest kaustas ~/.local/share/t3code, mitte paketist, nii et see värskendab ennast. Selle installimine küsib, kas alustada Stable või Nightly kanalil; vaheta hiljem T3 Code’i seadetes. Sinu lõimed ja seaded asuvad kaustas ~/.t3 ja T3 Code’i eemaldamine jaotises Remove > AI võtab need endaga kaasa.
Kohalikud LLM-id
Omarchy soovitab kohalike LLM-mudelite käitamiseks kahte viisi: LM Studio ja Ollama. LM Studio pakub GUI-liidest avatud kaaludega mudelite leidmiseks, nende installimiseks ja käitamiseks. See on suurepärane viis lihtsalt alustamiseks. Ollama pakub CLI-d, et teha seda sarnaselt. Kuid kui oled kohalike mudelitega alles alustamas, alustaksin mina LM Studioga. Saad kumbagi installida Omarchy menüüs jaotises Install > AI.
Omarchy skill
Agentide skillid aitavad AI-l kasutada konkreetseid tööriistu konkreetsel viisil ja Omarchy tarnitakse koos vaikimisi skilliga süsteemi kohandamiseks. Nagu sinu Hyprlandi konfiguratsiooni kohendamine, riba kohandamine või isegi uue teema loomine nullist. See on sümbolitega seotud Claude Code’i (~/.claude/skills), Codexi (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermese (~/.hermes/skills ja iga ~/.hermes/profiles/*/skills) skillide kataloogidesse ja üldisse ~/.agents/skills asukohta, nii et enamik harness’eid võtab selle automaatselt üles.
Kuid peaksid sellesse skilli suhtuma kui eksperimentaalsesse. Erinevad mudelid kasutavad seda erineva tulemusega. Parim on käitada seda kõigepealt planeerimisrežiimis, et sul oleks ettekujutus sellest, mida agent muuta tahaks. Ja seejärel ole valmis muudatusi tagasi võtma või isegi käivitama omarchy reinstall configs, kui agent teeb kõigest segaduse.