Vadovas
AI
Omarchy apima toliau nurodytų programavimo agentų paleidimo priemones, tačiau neparenka jums numatytojo. Paleiskite komandą, kad pirmojo naudojimo metu būtų įdiegtas jos CLI, tada, kai būsite paraginti, autentifikuokitės. Hermes yra išimtis: pirmojo naudojimo metu jam niekas neįdiegiama, o jį pasirinkus įdiegiama Hermes Desktop, kaip toliau paaiškinama skyriuje Desktop apps.
| Command | 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 from Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuff’s free, ad-supported coding agent |
grok |
Grok Build from xAI |
hermes |
Hermes, Nous Research’s agent |
kilo |
Kilo, an OpenCode-based coding agent |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMax’s coding agent |
muse |
Muse Code, Meta’s coding agent |
omp |
Oh My Pi |
ori |
Ori, OpenRouter’s harness |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code, Alibaba’s coding agent |
ori yra išskirtinis: jis paleidžia kitus dirbtuvinius rinkinius su visu OpenRouter modelių katalogu, todėl ori claude, ori codex arba ori opencode paleidžia tuos agentus su bet kuriuo modeliu, kurį jiems nurodote, o ori code yra paties Ori agentas.
Agentų diegimas ir atnaujinimas
Išskyrus Hermes, šie agentai naudoja mise tingųjį diegimą: pirmasis paleidimas įdiegia CLI, o vėlesni paleidimai jį naudoja iš naujo. mise taip pat tikrina, ar įdiegtam agentui nėra naujos versijos, ne dažniau kaip kartą per keturias valandas, prieš pat jo paleidimą arba fone terminalo eilutėje. Jei tas atnaujinimas nepavyksta arba esate atjungti nuo interneto, paleidžiama įdiegta versija. omarchy update atnaujina įdiegtus agentus kartu su likusia Omarchy dalimi, o mup atnaujina tik mise valdomus įrankius.
Agento nuosavas atnaujintojas, pavyzdžiui, claude update, codex update arba programoje esantis atnaujinimo mygtukas, neatnaujina mise valdomo diegimo. codex update nepavyksta, o claude update gali pranešti apie sėkmę, nors įdiegė atskirą kopiją, kurios mise neseka. Jei verčiau norėtumėte naudoti agento nuosavą diegimo ir atnaujinimo priemonę, įtraukite jį į disable_tools; žr. Iš anksto įdiegti CLI įrankiai.
Norėdami įdiegti visus sukonfigūruotus tingiuosius įrankius prieš tai, kai jų prireiks, paleiskite mise install --include-lazy. Tai apima ir kitus numatytuosius Omarchy CLI įrankius, ir agentus. Kaip įdiegti vieną įrankį arba naudoti savo diegimą, žr. Iš anksto įdiegti CLI įrankiai.
grok įdiegiamas per mise pirmosios šalies grok paketą, taip pat kaip claude ir codex. Paleiskite grok arba pasirinkite jį skiltyje Setup > Defaults > Agent. Praleiskite curl | bash diegimo programą svetainėje x.ai. Tas būdas įdeda antrą kopiją į ~/.grok/bin, įrašo ją į PATH pradžią ir perrašo Omarchy apvalkalą.
dsh atveria savo naršyklės UI adresu 127.0.0.1:3080, o paleidimo katalogas yra jo numatytoji darbo sritis. Jo naršyklės UI nepriima pradinės užklausos, todėl omarchy agent prompt ją atveria su užklausa jūsų iškarpinėje, kad galėtumėte įklijuoti. Omarchy ją paleidžia su DeepSeek leidimų išankstiniu nustatymu be patvirtinimo. DeepSeek Harness įkelia seansų žurnalus į DeepSeek, kai naudojate oficialią jos modelio API; išjunkite tai jo naršyklės UI skiltyje Settings > General > Upload Session Log. Jūsų siunčiami atsiliepimai taip pat įkeliami kartu su seansu, nebent paleidžiate ją su DSH_TELEMETRY_MODE=DISABLED.
Numatytasis agentas
Pasirinkite numatytąjį agentą komanda omarchy default agent <name> arba Omarchy Menu (Super + Space) skiltyje Setup > Defaults > Agent. Jei agentas dar neįdiegtas, jį pasirinkus jis pirmiausia įdiegiamas. Šviežia Omarchy pakvies jus atlikti šį pasirinkimą vienkartiniu pranešimu.
Pasirinkus Claude, taip pat bandoma nustatyti jo naršyklės plėtinį, skirtą Chromium, Chrome, Brave, Brave Origin ir Edge. Plėtinio nustatymas taikomas visiems naudotojams ir gali paprašyti jūsų sistemos slaptažodžio; atšaukus arba nepavykus įdiegti plėtinio, Claude vis tiek pasirenkamas ir paleidžiamas. Iš naujo paleiskite naršyklę, kai būsite paraginti, įjunkite plėtinį ir prisijunkite prie Claude, kad užbaigtumėte jo prijungimą. Paleiskite /chrome programoje Claude, kad patikrintumėte ryšį. Firefox ir Zen šio plėtinio nepalaiko. Jei Claude jau buvo jūsų numatytasis prieš pridedant šį nustatymą, pasirinkite jį dar kartą, kad įdiegtumėte plėtinį.
Kai pasirinksite, Super + Shift + Ctrl + A paleidžia numatytąjį agentą skirtame terminalo lange (arba atveria pasirinkimo langą, jei dar nepasirinkote). Taip pat galite paleisti jį tiesiai į užduotį komanda omarchy agent prompt "Review this project". Freebuff ir DeepSeek Harness nepriima pradinės užklausos, todėl jie atsidaro su užklausa jūsų iškarpinėje, kad galėtumėte įklijuoti. Tokiu būdu paleisti agentai veikia be priežiūros savo atitinkamuose režimuose, kai nesustoja paklausti, todėl būkite pasirengę, kad jie iš tiesų imsis veiksmų! MiniMax Code neturi tokio režimo savo interaktyviems seansams, todėl jis prašo leidimų kaip įprasta. O kadangi agentai atsisako prisiminti pasitikėjimą jūsų namų katalogu, paleidimai iš $HOME vietoj to prasideda kataloge ~/Work.
Taip pat yra terminalo sparčiųjų klavišų: a paleidžia numatytąjį agentą eilutėje dabartiniame terminale, o c, cx ir cy tiesiogiai paleidžia OpenCode, Claude Code ir Codex (vėlgi jų automatinio tvirtinimo režimais). Temų pakeitimai taip pat sinchronizuojami su agentais: Claude Code, Pi, OpenCode ir Hermes (kai Omarchy jį įdiegia) visi seka paskui, kai perjungiate Omarchy temą.
Agentų skydelis
Viršutinėje juostoje yra agentų piktograma. Prieš jums nustatant agentą, jo skydelis žingsnis po žingsnio padeda prisijungti prie Claude, Codex arba Grok, o pirmasis pasirinktas tampa jūsų numatytuoju agentu. Po to skydelis suveda kiekvieną prenumeratą į vieną puslapį: kiekvieną agentą ir paskyrą su jos planu, kiekvieno jo 5 valandų seanso ir savaitinių limitų matuoklį su laiku iki atstatymo (užveskite pelę, kad pamatytumėte tikslų procentą) arba likusį iš anksto apmokėtą likutį, po eilute, kuri keičiasi rodydama, ką sunaudojote visuose juose, pavyzdžiui, žetonus šią savaitę ir dažniausiai naudojamą modelį. Skiltyje Make something jis siūlo pradines užklausas naujai temai, papildiniui arba programai, kurios perduoda užduotį jūsų numatytajam agentui. Programos kuriamos taip, kaip kuriamos pačios Omarchy Hype, Monologue ir Omacut, naudojant C++ ir Qt Quick, laikantis omarchy-app agento įgūdžio, o joms reikalingas kompiliatorius ir Qt dalys jau įdiegti. Claude Code, Codex, Grok, Kimi, Cursor ir jo Grok Bot limitas, GitHub Copilot, Muse, Antigravity, Kimchi ir Devin yra padengti iš karto su jų limitais, o Hermes, Mistral Vibe ir Qwen Code rodo savo seansus ir žetonus, kai jais pasinaudojate. Teikėjų planai ir raktai, kuriuos naudojate per pi, omp arba opencode, taip pat pasirodo: OpenCode Zen ir Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan ir Synthetic su jų limitais; Fireworks, OpenRouter ir DeepSeek su jų iš anksto apmokėtais likučiais; ir modeliai, kuriuos paleidžiate savo aparatinėje įrangoje, skiltyje Local models. Kiekvienas agentas skaičiuojamas vieną kartą, pas tą, kas už jį pateikia sąskaitą, nesvarbu, per kiek dirbtuvinių rinkinių jį valdote.
Spustelėkite kairiuoju pelės mygtuku juostos piktogramą, kad atvertumėte skydelį, dešiniuoju – kad paleistumėte numatytąjį agentą. Už jo esantys naudojimo įrašai kas 15 minučių iš naujo sugeneruojami komanda omarchy agent usage-update, o skydelis netgi gali sujungti naudojimo duomenis iš kitų jūsų kompiuterių per sinchronizuojamą aplanką. Visus nustatymus žr. README faile, esančiame $OMARCHY_PATH/shell/plugins/agents/.
Kelios prenumeratos
Jei mokate už daugiau nei vieną Claude, Codex arba Grok planą – pavyzdžiui, asmeninį Max ir darbinį – Omarchy gali išlaikyti juos visus prisijungusius ir judėti tarp jų. Pridėkite prenumeratą paspaudę + agentų skydelyje, kuris jus ten pat žingsnis po žingsnio ves, arba komanda omarchy agent account add claude Work (arba codex, arba grok). Jei CLI trūksta, jis įdiegiamas. Pirmoji teikėjo paskyra prisijungia per jūsų įprastą naršyklę, ten, kur CLI visada ieško. Kiekviena paskesnė prisijungia per privatų langą, kad paskyra, prie kurios jūsų naršyklė jau prisijungusi, nebūtų per klaidą pasirinkta; prisijunkite ten kaip paskyra, kurią pridedate, ir pirmiausia uždarykite bet kurį privatų langą, kurį jau buvote atidarę. Niekada neatsijunkite nuo CLI tam, kad tai padarytumėte: atsijungimas atšaukia išsaugotą prisijungimą, ir tą paskyrą tektų pridėti iš naujo.
Norėdami nukopijuoti prenumeratos prisijungimus į kitą Omarchy kompiuterį per SSH, paleiskite omarchy agent account copy user@laptop. Siuntėjas pateikia laikiną gavėją, kai paskirties vieta jo neturi įdiegto, todėl senesni Omarchy kompiuteriai gali priimti paskyras be atnaujinimo. Įdiegti gavėjai turi pirmenybę. Tai nukopijuoja visas Claude, Codex ir Grok prenumeratas; pridėkite teikėjų pavadinimus, kad jas pasirinktumėte, kaip antai omarchy agent account copy laptop claude. Paskyrų pavadinimai ir komandų ID atitinka šaltinį, įskaitant paskyras, jau esančias paskirties vietoje. Nesuklastotoms paskirties paskyroms suteikiamas skaitinis priesagas, jei jų pavadinimai konfliktuoja, o nustatymai, įgūdžiai, papildiniai ir pokalbių istorija lieka vietiniai kiekviename kompiuteryje.
Esami paskirties kredencialai išsaugomi. Šaltinio paskyros, jau prisijungusios ten, pavadinimas sinchronizuojamas nepakeičiant jos kredencialų; kitos paskyros pridedamos šalia jos. Norėdami pakeisti išsaugotus atitinkančių paskyrų kredencialus, naudokite omarchy agent account copy --replace laptop claude prieš tai užbaigę tos paskyros seansus paskirties vietoje. Šviežia paskirties vieta taip pat gauna šaltinio aktyvią paskyrą ir perjungimo nuostatas; jau įsitvirtinusi paskirties vieta išlaiko savąsias.
Kredencialai keliauja per SSH ir saugomi privačiuose failuose paskirties vietoje, todėl kopijuokite tik į kompiuterius, kuriais pasitikite. Tai vienkartinis kopijavimas, o ne nuolatinė sinchronizacija. Codex atnaujinimo žetonus gali pakeisti kitas kompiuteris, todėl nukopijuotam prisijungimui gali prireikti atnaujinimo; atskiri prisijungimai išlieka patikimiausias pasirinkimas naudojant vienu metu keliuose kompiuteriuose. Žr. Codex paskyros autentifikavimo gairės.
Vienam teikėjui aktyvi viena paskyra, ir kiekvienas naujas seansas prasideda kaip ji: cx, cy, paprastas claude, codex arba grok, viskas, kas paleidžiama per omarchy agent, ir scenarijai ar redaktoriai, kurie randa CLI PATH. Perjunkite komanda omarchy agent account use work (ir atgal komanda omarchy agent account use main) arba skydelyje paspaudę paskyros numerį, o tada Enter (arba spustelėję jos mygtuką Use). Jau veikiantys seansai lieka su paskyra, su kuria jie prasidėjo. Pokalbių istorija, nustatymai, įgūdžiai ir papildiniai bendrinami tarp paskyrų, todėl claude --continue tame pačiame aplanke tęsia nuo ten, kur baigėte su naująja paskyra.
Turint daugiau nei vieną paskyrą, skydelis rodo kiekvienos paskyros limitus greta, aktyviąją pažymėdamas. Pagal numatytuosius nustatymus Omarchy praneša, kai aktyvi paskyra viršija 95 % limito, o spustelėjus pranešimą perjungiama į paskyrą su didžiausia atsarga. Užveskite pelę ant paskyros eilutės skydelyje ir spustelėkite šalia Use pasirodžiusį Autoswitch (arba paspauskite m), arba paleiskite omarchy agent account mode auto, kad ji persijungtų pati; kol tai įjungta, Autoswitch užima Use vietą, o spustelėjus jį dar kartą grįžtama prie pranešimo. Pridėkite skaičių, kad pakeistumėte slenkstį, kaip antai omarchy agent account mode auto 90. Jei kiekviena paskyra viršija slenkstį, apie tai išgirsite vieną kartą, kartu su tuo, kuri paskyra pirmiausia atsilaisvins. Kol aktyvi paskyra yra per 15 punktų nuo savo slenksčio (80 % pagal numatytuosius nustatymus), jos limitai tikrinami kas tris minutes, o ne kas 15.
omarchy agent account list rodo kiekvieną paskyrą ir jos naujausius limitus, omarchy agent account remove work pamiršta vieną, o omarchy agent account rename primary Hey pervardija vieną (arba spustelėkite paskyros pavadinimą skydelyje). Šios komandos veikia su jūsų numatytojo agento paskyromis; norėdami pasiekti kitą teikėją, pirmiausia jį įvardykite, kaip antai omarchy agent account use codex side. Prisijungimas, kurį jau turėjote ~/.claude arba ~/.codex, yra Main paskyra ir lieka ten, kur yra. Paskyra, nenaudota daugiau nei maždaug aštuonias valandas, gali rodyti Sign-in required; spustelėkite ją, kad vėl prisijungtumėte prie tos paskyros tiesiog skydelyje, arba pradėkite joje seansą, kuris prisijungimą atnaujina pats. MCP serveriai, kuriuos turėjote, kai paskyra buvo pridėta, keliauja kartu su ja, tačiau tie, kuriuos vėliau pridedate komanda claude mcp add, pasiekia tik paskyrą, kurioje juos pridėjote. Claude Desktop ir įrankiai, sukonfigūruoti su absoliučiu keliu į CLI dvejetainį failą, paskui perjungimą neseka. Aiškus CLAUDE_CONFIG_DIR, CODEX_HOME arba GROK_HOME turi pirmenybę prieš pasirinktą paskyrą.
Strigčių diagnostika
Omarchy stebi systemd-coredump dėl procesų strigčių. Kai kas nors sugenda dėl segmentavimo klaidos, gausite pranešimą „Process crashed“ – spustelėkite jį, ir strigtis perduodama jūsų numatytajam agentui kartu su Omarchy diagnose-crash įgūdžiu, kuris veda agentą per faktų nustatymą iš atminties išklotinės ir sprendimą, ar apie strigtį verta pranešti kūrėjams. Taip pat galite paleisti jį rankiniu būdu bet kuriam PID iš coredumpctl list komanda omarchy agent crash <pid>.
Stebėjimas pagal numatytuosius nustatymus įjungtas. Išjunkite jį skiltyje Trigger > Toggle > Crash Capture (arba komanda omarchy toggle crash-capture) ir pranešimai sustos; omarchy agent crash <pid> vis tiek veikia rankiniu būdu.
Strigtis taip pat galima nutildyti po vieną programą, ką diagnostika jums pasiūlo pabaigoje. omarchy crash mute hyprland sustabdo pranešimus tik tai programai, omarchy crash mute hyprland off juos sugrąžina, o omarchy crash mute vienas pats išvardija, ką nutildėte. Jis taip pat džiaugiasi dvejetainio failo keliu kaip ir jo pavadinimu, todėl omarchy crash mute /usr/bin/hyprland daro tą patį. Pavadinimą su tarpu rašykite kabutėse, kaip antai omarchy crash mute 'Some App'. Visa kita vis tiek praneša, o nutildyta programa vis tiek stringa – tai paslepia priminimą, o nieko netaiso.
Desktop apps
Meniu Install > AI taip pat yra kelios grafinės AI programos: ChatGPT darbalaukio programa, Claude darbalaukio programa (Anthropic Linux beta versija su skirtukais Chat, Cowork ir Claude Code), Grok Bot pokalbiams su xAI modeliais, Hermes Desktop, OpenClaw, Perplexity darbalaukio programa ir T3 Code. Grok Bot yra darbalaukio pokalbių programa. Programavimo agentas yra komanda grok.
Hermes Desktop yra ta, apie kurią reikia žinoti, nes kompiuteris turi vieną Hermes, ir jis priklauso programai: Hermes visada įdiegiamas tik per programą, o komanda hermes, kurią paleidžia numatytasis agentas, priklauso programai. Pasirinkus Hermes kaip numatytąjį agentą, įdiegiama tas pats, ką įdiegia įrašas Install > AI: paketas ir Hermes vykdymo aplinka ~/.hermes, nustatyta paties Hermes diegimo programos, kas pirmą kartą užtrunka kelias minutes. Ta vykdymo aplinka yra tas vienintelis Hermes, kurį naudoja terminalo komanda hermes, numatytasis agentas ir programa, ir ji atsinaujina pati komanda hermes update, o ne laukia Omarchy leidimo. Ją įdiegus, Hermes taip pat perduodama Omarchy tema kaip apvalkalas pavadinimu omarchy, kurį kiekvienas Hermes paviršius seka, kai keičiate temas; pasirinkite kitą Hermes Appearance nustatymuose arba komanda /skin, jei verčiau norėtumėte, kad taip nebūtų, ir Omarchy tą pasirinkimą paliks ramybėje. Pašalinus programą skiltyje Remove > AI, Hermes pirmiausia uždaroma, įskaitant šliuzą, kartu pašalinama ta vykdymo aplinka ir išsaugomi jūsų pokalbiai, prisiminimai ir įgūdžiai, kuriuos Hermes parašė sau, nebent pasakysite kitaip: ji paklausia, pagal numatytuosius nustatymus atsakydama ne, ar tie duomenys ir jūsų ryšio nustatymai taip pat turėtų išnykti.
OpenClaw darbalaukio patirtis yra jo Control UI, kuri atsidaro kaip žiniatinklio programa, palaikoma jo paties vietinio šliuzo. OpenClaw gyvena ~/.openclaw ir atsinaujina pats: naudokite Control UI mygtuką „Update Gateway“ arba paleiskite openclaw update, ir šliuzas persikraus su nauja versija. Omarchy tik pasirenka leidimą, nuo kurio prasideda šviežias diegimas. Pašalinus OpenClaw skiltyje Remove > AI, kartu pašalinama šliuzo paslauga ir programa, o tada paklausiama, ar ~/.openclaw taip pat turėtų išnykti, nes ten laikomi jūsų pokalbiai ir kredencialai kartu su pačiu OpenClaw ir jo atsisiunčiamomis papildinių vykdymo aplinkomis; pagal numatytuosius nustatymus jis išsaugomas, o vėl įdiegus OpenClaw jis vėl jį paima.
T3 Code veikia iš savo oficialaus AppImage leidimo, esančio ~/.local/share/t3code, o ne iš paketo, todėl atsinaujina pats. Jį diegiant paklausiama, ar pradėti nuo Stable, ar Nightly kanalo; vėliau perjunkite T3 Code nustatymuose. Jūsų gijos ir nustatymai gyvena ~/.t3, o pašalinus T3 Code skiltyje Remove > AI, jie pašalinami kartu.
Vietiniai LLM
Omarchy rekomenduoja du vietinių LLM modelių paleidimo būdus: LM Studio ir Ollama. LM Studio suteikia GUI sąsają atvirosios prieigos modeliams rasti, įdiegti ir paleisti. Tai puikus būdas lengvai pradėti. Ollama siūlo CLI, kad tai būtų galima daryti panašiai. Bet jei esate naujokas vietinių modelių srityje, pradėčiau nuo LM Studio. Bet kurią iš jų galite įdiegti Omarchy Menu skiltyje Install > AI.
Omarchy įgūdis
Agentų įgūdžiai padeda AI naudoti konkrečius įrankius konkrečiu būdu, o Omarchy pateikiama su numatytuoju įgūdžiu sistemai pritaikyti. Pavyzdžiui, koreguoti Hyprland konfigūraciją, reguliuoti juostą ar net sukurti naują temą nuo nulio. Jis susietas simbolinėmis nuorodomis į įgūdžių katalogus, skirtus Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills ir kiekvieną ~/.hermes/profiles/*/skills) ir bendrąją ~/.agents/skills vietą, todėl dauguma dirbtuvinių rinkinių jį paima automatiškai.
Tačiau šį įgūdį turėtumėte laikyti eksperimentiniu. Skirtingi modeliai jį naudos su skirtingu poveikiu. Geriausia pirmiausia paleisti planavimo režimu, kad suprastumėte, ką agentas norėtų pakeisti. Ir tada būkite pasirengę atšaukti pakeitimus ar net paleisti omarchy reinstall configs, jei agentas viską sujauks.