Handbók
Gervigreind
Omarchy inniheldur ræsipunkta fyrir forritunarumboðsaðilana hér að neðan án þess að velja sjálfgefinn fyrir þig. Keyrðu skipun til að setja upp CLI hennar við fyrstu notkun og auðkenndu þig síðan þegar beðið er um það. Hermes er undantekningin: ekkert er sett upp fyrir hann við fyrstu notkun og þegar hann er valinn er Hermes Desktop sett upp, eins og Skrifborðsforrit hér að neðan útskýrir.
| Skipun | Umboðsaðili |
|---|---|
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 frá Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, ókeypis, auglýsingastuddur forritunarumboðsaðili Codebuff |
grok |
Grok Build frá xAI |
hermes |
Hermes, umboðsaðili Nous Research |
kilo |
Kilo, forritunarumboðsaðili byggður á OpenCode |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, forritunarumboðsaðili MiniMax |
muse |
Muse Code, forritunarumboðsaðili Meta |
omp |
Oh My Pi |
ori |
Ori, beisli OpenRouter |
pi |
Pi eftir Mario Zechner |
qwen |
Qwen Code, forritunarumboðsaðili Alibaba |
ori sker sig úr: það keyrir hin beislin gegn öllu líkanasafni OpenRouter, svo ori claude, ori codex eða ori opencode ræsa þá umboðsaðila á því líkani sem þú beinir þeim að, og ori code er eigin umboðsaðili Ori.
Uppsetning og uppfærsla umboðsaðila
Að Hermes undanskildum nota þessir umboðsaðilar seinvirka uppsetningu mise: fyrsta ræsing setur upp CLI-ið og síðari ræsingar endurnota það. mise leitar einnig að nýrri útgáfu uppsetts umboðsaðila að hámarki einu sinni á fjögurra klukkustunda fresti, rétt áður en hann er ræstur eða í bakgrunni við skeljarkvaðningu. Ef sú uppfærsla mistekst eða þú ert ótengd/ur, keyrir uppsetta útgáfan. omarchy update uppfærir uppsetta umboðsaðila ásamt restinni af Omarchy, og mup uppfærir aðeins tól sem mise stýrir.
Eigin uppfærslutól umboðsaðila, eins og claude update, codex update eða uppfærsluhnappur í forriti, uppfærir ekki uppsetninguna sem mise stýrir. codex update mistekst, og claude update getur tilkynnt árangur á meðan það setur upp aðskilið eintak sem mise fylgist ekki með. Ef þú vilt frekar nota innbyggt uppsetningar- og uppfærslutól umboðsaðila skaltu bæta honum við disable_tools; sjá Forsett CLI-tól.
Til að setja upp öll stillt seinvirk tól áður en þú þarft á þeim að halda skaltu keyra mise install --include-lazy. Þetta felur einnig í sér önnur sjálfgefin CLI-tól Omarchy ásamt umboðsaðilunum. Sjá Forsett CLI-tól um uppsetningu á einu tóli eða notkun eigin uppsetningar.
grok er sett upp í gegnum fyrsta flokks grok pakka mise, á sama hátt og claude og codex. Keyrðu grok, eða veldu það undir Uppsetning > Sjálfgefið > Umboðsaðili. Slepptu curl | bash uppsetningarforritinu á x.ai. Sú leið setur annað eintak í ~/.grok/bin, setur það fremst á PATH og skrifar yfir umbúnað Omarchy.
dsh opnar vafraviðmót sitt á 127.0.0.1:3080, með ræsimöppuna sem sjálfgefið vinnusvæði. Vafraviðmótið tekur enga upphafskvaðningu, svo omarchy agent prompt opnar það með kvaðninguna á klippiborðinu þínu til að líma. Omarchy ræsir það með forstillingu DeepSeek um heimild án samþykkis. DeepSeek Harness sendir lotuannála til DeepSeek þegar þú notar opinbera líkana-API þess; slökktu á því undir Stillingar > Almennt > Senda lotuannál í vafraviðmótinu. Endurgjöf sem þú sendir því er einnig send með lotunni, nema þú ræsir það með DSH_TELEMETRY_MODE=DISABLED.
Sjálfgefni umboðsaðilinn
Veldu sjálfgefinn umboðsaðila með omarchy default agent <name> eða undir Uppsetning > Sjálfgefið > Umboðsaðili í Omarchy-valmyndinni (Super + Space). Ef umboðsaðilinn er ekki þegar uppsettur mun val á honum setja hann upp fyrst. Ný Omarchy-uppsetning mun bjóða þér að taka þessa ákvörðun með einnar skiptis tilkynningu.
Þegar Claude er valið er einnig reynt að setja upp vafraviðbót þess fyrir Chromium, Chrome, Brave, Brave Origin og Edge. Uppsetning viðbótarinnar á við um alla notendur og gæti beðið um kerfislykilorðið þitt; að hætta við eða ef uppsetning viðbótar mistekst velur og ræsir samt Claude. Endurræstu vafrann, virkjaðu viðbótina ef beðið er um það og skráðu þig inn á Claude til að ljúka tengingu hennar. Keyrðu /chrome í Claude til að athuga tenginguna. Firefox og Zen styðja ekki þessa viðbót. Ef Claude var þegar sjálfgefinn umboðsaðili þinn áður en þessari uppsetningu var bætt við skaltu velja það aftur til að setja viðbótina upp.
Þegar þú hefur valið lætur Super + Shift + Ctrl + A sjálfgefna umboðsaðilann ræsast í sérstökum útstöðvarglugga (eða birtir valkostinn ef þú hefur ekki valið ennþá). Þú getur líka ræst það beint inn í verkefni með omarchy agent prompt "Review this project". Freebuff og DeepSeek Harness taka enga upphafskvaðningu, svo þau opnast þess í stað með kvaðninguna á klippiborðinu þínu til að líma. Umboðsaðilar sem ræstir eru á þennan hátt keyra án eftirlits í sínum eigin ham þar sem ekki er stoppað til að spyrja, svo vertu tilbúin/n fyrir að þeir geri hluti í raun og veru! MiniMax Code hefur engan slíkan ham fyrir gagnvirkar lotur sínar, svo það biður um heimildir eins og venjulega. Og þar sem umboðsaðilar neita að muna traust fyrir heimamöppuna þína byrja ræsingar frá $HOME í ~/Work í staðinn.
Það eru líka flýtileiðir í útstöð: a keyrir sjálfgefna umboðsaðilann innbyggt í núverandi útstöð, á meðan c, cx og cy ræsa OpenCode, Claude Code og Codex beint (aftur í sjálfvirkt samþykkjandi ham þeirra). Þemabreytingar samstillast einnig við umboðsaðilana: Claude Code, Pi, OpenCode og Hermes (þegar Omarchy hefur sett það upp) fylgja öll með þegar þú skiptir um Omarchy-þema.
Umboðsaðilaborðið
Efri stikuna hefur umboðsaðilatákn. Áður en þú hefur sett upp umboðsaðila leiðir borðið þig í gegnum innskráningu á Claude, Codex eða Grok, og sá fyrsti verður sjálfgefinn umboðsaðili þinn. Eftir það setur borðið hverja áskrift á eina síðu: hvern umboðsaðila og reikning með áætlun sinni, mæli fyrir hvert 5 klukkustunda lotutakmark og vikulegt takmark með tímanum fram að endurstillingu (hvíldu yfir fyrir nákvæma prósentu), eða eftirstandandi fyrirframgreidda inneign, undir línu sem skiptir um það sem þú hefur notað á þeim öllum, eins og tóken í þessari viku og mest notaða líkanið þitt. Undir Búa til eitthvað býður það upp á byrjunarkvaðningar fyrir nýtt þema, viðbót eða forrit sem afhenda verkefnið sjálfgefna umboðsaðilanum þínum. Forrit eru byggð á sama hátt og eigin Hype, Monologue og Omacut Omarchy, í C++ og Qt Quick, samkvæmt omarchy-app umboðsaðilafærninni, og þýðandinn og Qt-hlutirnir sem þau þurfa fylgja uppsettir. Claude Code, Codex, Grok, Kimi, Cursor og Grok Bot heimild þess, GitHub Copilot, Muse, Antigravity, Kimchi og Devin eru studd beint með takmörkum sínum, og Hermes, Mistral Vibe og Qwen Code sýna lotur sínar og tóken þegar þú hefur notað þau. Áætlanir og lyklar veitenda sem þú notar í gegnum pi, omp eða opencode birtast einnig: OpenCode Zen og Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan og Synthetic með takmörkum sínum; Fireworks, OpenRouter og DeepSeek með fyrirframgreiddum inneignum sínum; og líkönin sem þú keyrir á eigin vélbúnaði undir Staðbundin líkön. Sérhver umboðsaðili er talinn einu sinni, undir þeim sem rukkar fyrir hann, sama hversu mörgum beislum þú keyrir hann í gegnum.
Vinstrismelltu á táknið á stikunni fyrir borðið, hægrismelltu til að ræsa sjálfgefna umboðsaðilann þinn. Notkunarskrárnar á bak við það eru endurgerðar á 15 mínútna fresti með omarchy agent usage-update, og borðið getur jafnvel sameinað notkun frá öðrum vélum þínum í gegnum samstillta möppu. Sjá README undir $OMARCHY_PATH/shell/plugins/agents/ fyrir allar stillingar.
Nokkrar áskriftir
Ef þú borgar fyrir fleiri en eina Claude-, Codex- eða Grok-áætlun - persónulega Max og vinnuáætlun, segjum - getur Omarchy haldið þeim öllum innskráðum og fært sig á milli þeirra. Bættu við áskrift með + í umboðsaðilaborðinu, sem leiðir þig í gegnum það þar, eða með omarchy agent account add claude Work (eða codex, eða grok). Það setur upp CLI-ið ef það vantar. Fyrsti reikningurinn fyrir veitanda skráir sig inn í gegnum venjulega vafrann þinn, þar sem CLI-ið leitar alltaf. Sérhver reikningur eftir það skráir sig inn í gegnum einkaglugga, svo reikningurinn sem vafrinn þinn er þegar skráður inn á verði ekki tekinn fyrir mistök; skráðu þig þar inn sem reikningurinn sem þú ert að bæta við, og lokaðu fyrst öllum einkagluggum sem þú hafðir þegar opna. Aldrei skrá þig út úr CLI-inu til að gera þetta: útskráning afturkallar vistaða innskráningu, og þeim reikningi þyrfti að bæta við aftur.
Til að afrita áskriftarinnskráningar þínar á aðra Omarchy-vél yfir SSH skaltu keyra omarchy agent account copy user@laptop. Sendandinn útvegar tímabundinn móttakanda þegar áfangastaðurinn hefur engan uppsettan, svo eldri Omarchy-vélar geti tekið við reikningum án uppfærslu. Uppsettir móttakendur hafa forgang. Þetta afritar allar Claude-, Codex- og Grok-áskriftir; bættu við nöfnum veitenda til að velja þær, eins og í omarchy agent account copy laptop claude. Nöfn reikninga og skipanaauðkenni passa við upprunann, þar á meðal reikninga sem þegar eru til staðar á áfangastaðnum. Ótengdir reikningar á áfangastað fá tölulegt viðskeyti ef nöfn þeirra rekast á, og stillingar, færni, viðbætur og samtalasaga haldast staðbundin á hverri vél.
Núverandi skilríki á áfangastað eru varðveitt. Upprunareikningur sem þegar er innskráður þar fær nafn sitt samstillt án þess að skipta skilríkjum hans út; öðrum reikningum er bætt við við hliðina á honum. Til að skipta út vistuðum skilríkjum fyrir samsvarandi reikninga skaltu nota omarchy agent account copy --replace laptop claude eftir að þú hefur hætt lotum þess reiknings á áfangastaðnum. Nýr áfangastaður fær einnig virka reikning upprunans og skiptivalkosti; rótgróinn áfangastaður heldur sínum eigin.
Skilríki ferðast í gegnum SSH og eru geymd í einkaskrám á áfangastaðnum, svo afritaðu aðeins á vélar sem þú treystir. Þetta er einu sinni afrit, ekki áframhaldandi samstilling. Hægt er að skipta um Codex endurnýjunartóken af annarri vél, sem skilur afritaða innskráningu eftir í þörf fyrir endurnýjun; aðskildar innskráningar eru áreiðanlegasti valkosturinn fyrir samtímanotkun á nokkrum vélum. Sjá leiðbeiningar Codex um auðkenningu reikninga.
Einn reikningur á veitanda er virkur, og sérhver ný lota byrjar sem hann: cx, cy, venjulegt claude, codex eða grok, allt sem ræst er í gegnum omarchy agent, og forskriftir eða ritlar sem finna CLI-ið á PATH. Skiptu með omarchy agent account use work (og til baka með omarchy agent account use main), eða í borðinu með því að ýta á númer reiknings og síðan Enter (eða smella á Use hnappinn hans). Lotur sem þegar eru í gangi haldast á reikningnum sem þær byrjuðu á. Samtalasaga, stillingar, færni og viðbætur eru samnýttar á milli reikninga, svo claude --continue í sömu möppu heldur áfram þar sem þú hættir á nýja reikningnum.
Með fleiri en einum reikningi sýnir borðið takmörk hvers reiknings hlið við hlið, með þann virka merktan. Sjálfgefið lætur Omarchy þig vita þegar virki reikningurinn fer yfir 95% af takmarki, og þegar smellt er á tilkynninguna skiptir það yfir á reikninginn með mestu svigrúmi. Hvíldu yfir línu reiknings í borðinu og smelltu á Autoswitch sem birtist við hliðina á Use (eða ýttu á m), eða keyrðu omarchy agent account mode auto, til að láta það skipta sjálfkrafa í staðinn; á meðan það er virkt tekur Autoswitch sæti Use, og þegar smellt er á það aftur ferðu aftur í tilkynningar. Bættu við tölu til að breyta þröskuldinum, eins og í omarchy agent account mode auto 90. Ef sérhver reikningur er yfir þröskuldinum færðu að heyra um það einu sinni, ásamt því hvaða reikningur losnar fyrst. Á meðan virkur reikningur er innan 15 stiga frá þröskuldi sínum (80% við sjálfgefið) eru takmörk hans athuguð á þriggja mínútna fresti frekar en á 15 mínútna fresti.
omarchy agent account list sýnir sérhvern reikning og nýjustu takmörk hans, omarchy agent account remove work gleymir einum, og omarchy agent account rename primary Hey endurnefnir einn (eða smelltu á nafn reiknings í borðinu). Þessar skipanir virka á reikninga sjálfgefna umboðsaðilans þíns; til að ná til hinnar veitunnar skaltu nefna hana fyrst, eins og í omarchy agent account use codex side. Innskráningin sem þú hafðir þegar í ~/.claude eða ~/.codex er Main reikningurinn og helst þar sem hún er. Reikningur sem er ónotaður í meira en um átta klukkustundir getur sýnt Innskráning nauðsynleg; smelltu á hann til að skrá þann reikning inn aftur beint í borðinu, eða ræstu lotu í honum, sem endurnýjar innskráninguna sjálfkrafa. MCP-þjónar sem þú hafðir þegar reikningi var bætt við fylgja honum, en þeir sem þú bætir við síðar með claude mcp add ná aðeins til reikningsins sem þú bættir þeim við í. Claude Desktop og tól sem stillt eru með algerri slóð að CLI tvíundaskrá fylgja ekki skiptinu. Skýrt CLAUDE_CONFIG_DIR, CODEX_HOME eða GROK_HOME hefur forgang fram yfir valinn reikning.
Greining á hruni
Omarchy fylgist með systemd-coredump vegna hruns ferla. Þegar eitthvað segfault-ar færðu tilkynningu um „Ferli hrundi“ - smelltu á hana, og hrunið er afhent sjálfgefna umboðsaðilanum þínum ásamt diagnose-crash færni Omarchy, sem leiðir umboðsaðilann í gegnum að staðfesta staðreyndirnar úr kjarnadumpinu og ákveða hvort hrunið sé þess virði að tilkynna það andstreymis. Þú getur líka keyrt það handvirkt gegn hvaða PID sem er úr coredumpctl list með omarchy agent crash <pid>.
Eftirlitið er sjálfgefið virkt. Slökktu á því undir Kveikja > Víxla > Hrunupptaka (eða með omarchy toggle crash-capture) og tilkynningarnar hætta; omarchy agent crash <pid> virkar samt handvirkt.
Einnig er hægt að þagga niður í hrunum eitt forrit í einu, sem er það sem greiningin býður þér í lokin. omarchy crash mute hyprland stöðvar tilkynningarnar fyrir það forrit eitt, omarchy crash mute hyprland off færir þær aftur, og omarchy crash mute eitt og sér listar það sem þú hefur þaggað. Það tekur slóð tvíundaskrárinnar jafn gjarnan og nafn hennar, svo omarchy crash mute /usr/bin/hyprland gerir það sama. Settu nafn með bili í gæsalappir, eins og í omarchy crash mute 'Some App'. Allt annað tilkynnir samt, og þaggaða forritið hrynur samt - þetta felur áminninguna, það lagar ekkert.
Skrifborðsforrit
Install > AI valmyndin inniheldur einnig nokkur myndræn gervigreindarforrit: ChatGPT skrifborðsforritið, Claude skrifborðsforritið (Linux beta Anthropic, með Chat, Cowork og Claude Code flipum), Grok Bot til að spjalla við líkön xAI, Hermes Desktop, OpenClaw, Perplexity skrifborðsforritið og T3 Code. Grok Bot er skrifborðsspjalforritið. Forritunarumboðsaðilinn er grok skipunin.
Hermes Desktop er það sem þarf að vita um, því vél hefur einn Hermes, og hann tilheyrir forritinu: Hermes er aðeins nokkurn tímann settur upp í gegnum forritið, og hermes skipunin sem sjálfgefni umboðsaðilinn keyrir tilheyrir forritinu. Að velja Hermes sem sjálfgefinn umboðsaðila setur upp það sama og Install > AI færslan gerir: pakkann, og Hermes keyrslutíma undir ~/.hermes sem eigin uppsetningarforrit Hermes setur upp, sem tekur nokkrar mínútur í fyrsta skipti. Sá keyrslutími er sá eini Hermes sem hermes skipunin í útstöðinni, sjálfgefni umboðsaðilinn og forritið nota öll, og hann uppfærir sig sjálfur með hermes update frekar en að bíða eftir Omarchy-útgáfu. Uppsetning hans afhendir Hermes einnig Omarchy-þemað sem skinn að nafni omarchy, sem sérhvert Hermes-yfirborð fylgir þegar þú skiptir um þemu; veldu annað undir Appearance stillingum Hermes eða með /skin ef þú vilt frekar ekki, og Omarchy lætur það val í friði. Að fjarlægja forritið undir Remove > AI lokar Hermes fyrst, gáttinni meðtalinni, tekur þann keyrslutíma með sér og geymir spjöll þín, minningar og færnina sem Hermes skrifaði fyrir sig nema þú segir því annað: það spyr, með nei sem sjálfgefið, hvort þau gögn og tengistillingar þínar ættu einnig að fara.
Skrifborðsupplifun OpenClaw er Control UI þess, sem opnast sem vefforrit stutt af eigin staðbundinni gátt. OpenClaw býr í ~/.openclaw og uppfærir sig sjálft: notaðu „Update Gateway“ hnapp Control UI eða keyrðu openclaw update, og gáttin endurræsist á nýju útgáfunni. Omarchy velur aðeins útgáfuna sem ný uppsetning byrjar á. Að fjarlægja OpenClaw undir Remove > AI tekur gáttarþjónustuna og forritið með sér og spyr síðan hvort ~/.openclaw ætti einnig að fara, þar sem það geymir spjöll þín og skilríki ásamt OpenClaw sjálfu og viðbótarkeyrslutímunum sem það hleður niður; sjálfgefið er að halda því, og uppsetning OpenClaw aftur tekur það upp aftur.
T3 Code keyrir frá opinberri AppImage útgáfu sinni í ~/.local/share/t3code frekar en úr pakka, svo það uppfærir sig sjálft. Uppsetning þess spyr hvort byrja eigi á Stable eða Nightly rásinni; skiptu síðar í stillingum T3 Code. Þræðir þínir og stillingar búa í ~/.t3, og að fjarlægja T3 Code undir Remove > AI tekur þau með sér.
Staðbundin LLM
Omarchy mælir með tveimur leiðum til að keyra staðbundin LLM-líkön: LM Studio og Ollama. LM Studio veitir GUI-viðmót til að finna opin líkön, setja þau upp og keyra þau. Það er frábær leið til að komast auðveldlega af stað. Ollama býður upp á CLI til að gera það á svipaðan hátt. En ef þú ert nýr í staðbundnum líkönum myndi ég byrja með LM Studio. Þú getur sett hvort tveggja upp undir Install > AI í Omarchy-valmyndinni.
Omarchy-færnin
Umboðsaðilafærni hjálpar gervigreind að nota tiltekin tól á tiltekinn hátt, og Omarchy fylgir sjálfgefin færni til að sérsníða kerfið. Eins og að fínstilla Hyprland stillinguna þína, aðlaga stikuna, eða jafnvel búa til nýtt þema frá grunni. Hún er tákntengd inn í færnimöppurnar fyrir Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills og hverja ~/.hermes/profiles/*/skills), og almennu ~/.agents/skills staðsetninguna, svo flest beisli taka hana upp sjálfkrafa.
En þú ættir að meðhöndla þessa færni sem tilraunakennda. Mismunandi líkön munu nota hana með mismunandi árangri. Best er að keyra fyrst í áætlanaham, svo þú hafir hugmynd um hvað umboðsaðilanum langar að breyta. Og vertu síðan tilbúin/n að afturkalla breytingar eða jafnvel kalla fram omarchy reinstall configs, ef umboðsaðilinn gerir allt að sóðaskap.