Ohjekirja
Tekoäly
Omarchy sisältää käynnistimet alla oleville koodausagenteille valitsematta oletusta puolestasi. Suorita komento asentaaksesi sen CLI:n ensimmäisellä käyttökerralla ja todista pääsysi sitten kehotettaessa. Hermes on poikkeus: sille ei asenneta mitään ensimmäisellä käyttökerralla, ja sen valitseminen asentaa Hermes Desktopin, kuten alla oleva Työpöytäsovellukset selittää.
| Komento | Agentti |
|---|---|
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 Cognitionilta |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuffin ilmainen, mainoksilla tuettu koodausagentti |
grok |
Grok Build xAI:lta |
hermes |
Hermes, Nous Researchin agentti |
kilo |
Kilo, OpenCode-pohjainen koodausagentti |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMaxin koodausagentti |
muse |
Muse Code, Metan koodausagentti |
omp |
Oh My Pi |
ori |
Ori, OpenRouterin harness |
pi |
Mario Zechnerin Pi |
qwen |
Qwen Code, Alibaban koodausagentti |
ori on joukon outolintu: se ajaa muita harness-ohjelmia OpenRouterin koko mallivalikoimaa vasten, joten ori claude, ori codex tai ori opencode käynnistävät kyseiset agentit millä tahansa mallilla, johon osoitat ne, ja ori code on Orin oma agentti.
Agenttien asentaminen ja päivittäminen
Hermesiä lukuun ottamatta nämä agentit käyttävät misen laiskaa asennusta: ensimmäinen käynnistys asentaa CLI:n, ja myöhemmät käynnistykset käyttävät sitä uudelleen. mise tarkistaa myös asennetun agentin uuden julkaisun korkeintaan kerran neljässä tunnissa, juuri ennen sen käynnistymistä tai taustalla komentotulkin kehotteessa. Jos päivitys epäonnistuu tai olet offline-tilassa, asennettu versio käynnistyy. omarchy update päivittää asennetut agentit muun Omarchyn mukana, ja mup päivittää vain misen hallinnoimat työkalut.
Agentin oma päivitysohjelma, kuten claude update, codex update tai sovelluksen päivityspainike, ei päivitä misen hallinnoimaa asennusta. codex update epäonnistuu, ja claude update voi ilmoittaa onnistumisesta samalla, kun se asentaa erillisen kopion, jota mise ei seuraa. Jos haluat mieluummin käyttää agentin omaa asennus- ja päivitysohjelmaa, lisää se luetteloon disable_tools; katso Esiasennetut CLI-työkalut.
Asentaaksesi kaikki määritetyt laiskat työkalut ennen kuin tarvitset niitä, suorita mise install --include-lazy. Tämä sisältää Omarchyn muut oletus-CLI-työkalut sekä agentit. Katso Esiasennetut CLI-työkalut yksittäisen työkalun asentamisesta tai oman asennuksesi käyttämisestä.
grok asennetaan misen oman grok-paketin kautta samalla tavalla kuin claude ja codex. Suorita grok tai valitse se kohdasta Setup > Defaults > Agent. Ohita x.ai:n curl | bash -asennusohjelma. Se polku laittaa toisen kopion kansioon ~/.grok/bin, lisää sen PATH-muuttujan alkuun ja ylikirjoittaa Omarchyn kääreen.
dsh avaa selainkäyttöliittymänsä osoitteessa 127.0.0.1:3080, ja käynnistyskansio on sen oletustyötila. Sen selainkäyttöliittymä ei ota aloituskehotetta, joten omarchy agent prompt avaa sen niin, että kehote on leikepöydälläsi liitettävänä. Omarchy käynnistää sen DeepSeekin hyväksyntää vaatimattomalla käyttöoikeusvalmiusasetuksella. DeepSeek Harness lähettää istuntolokit DeepSeekille, kun käytät sen virallista malli-APIa; kytke se pois päältä sen selainkäyttöliittymän kohdasta Settings > General > Upload Session Log. Myös sille lähettämäsi palaute lähetetään istunnon mukana, ellet käynnistä sitä komennolla DSH_TELEMETRY_MODE=DISABLED.
Oletusagentti
Valitse oletusagenttisi komennolla omarchy default agent <name> tai Omarchy-valikon kohdasta Setup > Defaults > Agent (Super + Space). Jos agenttia ei ole vielä asennettu, sen valitseminen asentaa sen ensin. Uusi Omarchy kutsuu sinut tekemään tämän valinnan kertailmoituksella.
Clauden valitseminen yrittää myös määrittää sen selainlaajennuksen Chromiumille, Chromelle, Bravelle, Brave Originille ja Edgelle. Laajennuksen asennus koskee kaikkia käyttäjiä ja saattaa pyytää järjestelmäsalasanaasi; laajennuksen asennuksen peruuttaminen tai epäonnistuminen valitsee ja käynnistää Clauden silti. Käynnistä selaimesi uudelleen, ota laajennus käyttöön pyydettäessä ja kirjaudu Claudeen viimeistelläksesi sen yhdistämisen. Suorita Claudessa /chrome tarkistaaksesi yhteyden. Firefox ja Zen eivät tue tätä laajennusta. Jos Claude oli jo oletuksesi ennen kuin tämä asennus lisättiin, valitse se uudelleen asentaaksesi laajennuksen.
Kun olet valinnut, Super + Shift + Ctrl + A käynnistää oletusagentin omassa terminaali-ikkunassaan (tai avaa valitsimen, jos et ole vielä valinnut). Voit myös käynnistää sen suoraan tehtävään komennolla omarchy agent prompt "Review this project". Freebuff ja DeepSeek Harness eivät ota aloituskehotetta, joten ne avautuvat sen sijaan niin, että kehote on leikepöydälläsi liitettävänä. Näin käynnistetyt agentit toimivat valvomatta omissa älä-pysähdy-kysymään-tiloissaan, joten ole valmis siihen, että ne todella tekevät asioita! MiniMax Codessa ei ole tällaista tilaa sen vuorovaikutteisille istunnoille, joten se pyytää käyttöoikeuksia tavalliseen tapaan. Ja koska agentit kieltäytyvät muistamasta kotikansiosi luottamusta, käynnistykset $HOME-kansiosta alkavat sen sijaan kansiosta ~/Work.
Terminaalipikanäppäimiäkin on: a ajaa oletusagentin nykyisessä terminaalissa samalla rivillä, kun taas c, cx ja cy käynnistävät OpenCoden, Claude Coden ja Codexin suoraan (jälleen niiden automaattisesti hyväksyvissä tiloissa). Teemanvaihdot synkronoituvat myös agentteihin: Claude Code, Pi, OpenCode ja Hermes (kun Omarchy on asentanut sen) seuraavat kaikki mukana, kun vaihdat Omarchy-teemaa.
Agenttipaneeli
Yläpalkissa on agenttikuvake. Ennen kuin olet määrittänyt agentin, sen paneeli opastaa sinut kirjautumaan Claudeen, Codexiin tai Grokiin, ja ensimmäisestä tulee oletusagenttisi. Sen jälkeen paneeli kokoaa jokaisen tilauksen yhdelle sivulle: jokaisen agentin ja tilin suunnitelmineen, mittarin sen jokaiselle 5 tunnin istunto- ja viikkorajalle sekä ajan sen nollaantumiseen (vie osoitin päälle nähdäksesi tarkan prosenttiosuuden), tai jäljellä olevan ennakkoon maksetun saldosi, rivin alla, joka kiertää niiden asioiden välillä, joita olet käyttänyt kaikissa niissä, kuten tämän viikon tokeneiden ja eniten käyttämäsi mallin välillä. Kohdan Make something alla se tarjoaa aloituskehotteita uudelle teemalle, laajennukselle tai sovellukselle, jotka antavat tehtävän oletusagentillesi. Sovellukset rakennetaan samalla tavalla kuin Omarchyn omat Hype, Monologue ja Omacut, C++:lla ja Qt Quickillä, omarchy-app-agenttitaitoa noudattaen, ja niiden tarvitsema kääntäjä ja Qt-osat tulevat asennettuina. Claude Code, Codex, Grok, Kimi, Cursor ja sen Grok Bot -kiintiö, GitHub Copilot, Muse, Antigravity, Kimchi ja Devin katetaan valmiina niiden rajoituksineen, ja Hermes, Mistral Vibe ja Qwen Code näyttävät istuntonsa ja tokeninsa, kun olet käyttänyt niitä. Myös pi:n, omp:n tai opencoden kautta käyttämäsi palveluntarjoajien suunnitelmat ja avaimet näkyvät: OpenCode Zen ja Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan ja Synthetic rajoituksineen; Fireworks, OpenRouter ja DeepSeek ennakkoon maksettuine saldoineen; sekä mallit, joita ajat omalla laitteistollasi, kohdassa Local models. Jokainen agentti lasketaan kerran, sen laskuttajan alla, riippumatta siitä, kuinka monen harness-ohjelman kautta sitä käytät.
Napsauta palkin kuvaketta hiiren vasemmalla painikkeella avataksesi paneelin, napsauta hiiren oikealla painikkeella käynnistääksesi oletusagenttisi. Sen taustalla olevat käyttötietueet luodaan uudelleen 15 minuutin välein komennolla omarchy agent usage-update, ja paneeli voi jopa yhdistää käyttötietoja muilta koneiltasi synkronoidun kansion kautta. Katso täydet asetukset README-tiedostosta kansiossa $OMARCHY_PATH/shell/plugins/agents/.
Useita tilauksia
Jos maksat useammasta kuin yhdestä Claude-, Codex- tai Grok-suunnitelmasta - esimerkiksi henkilökohtaisesta Maxista ja työsuunnitelmasta - Omarchy voi pitää ne kaikki kirjautuneina ja siirtyä niiden välillä. Lisää tilaus agenttipaneelin +-painikkeella, joka opastaa sinut sen läpi juuri siellä, tai komennolla omarchy agent account add claude Work (tai codex tai grok). Se asentaa CLI:n, jos se puuttuu. Palveluntarjoajan ensimmäinen tili kirjautuu tavallisen selaimesi kautta, juuri sieltä, mistä CLI aina etsii. Jokainen sen jälkeinen kirjautuu yksityisen ikkunan kautta, jotta tiliä, johon selaimesi on jo kirjautunut, ei poimita vahingossa; kirjaudu siellä tilinä, jota olet lisäämässä, ja sulje ensin kaikki jo avoinna olevat yksityiset ikkunat. Älä koskaan kirjaudu ulos CLI:stä tehdäksesi tämän: uloskirjautuminen peruuttaa tallennetun kirjautumisen, ja kyseinen tili pitäisi lisätä uudelleen.
Kopioidaksesi tilauskirjautumisesi toiselle Omarchy-koneelle SSH:n kautta, suorita omarchy agent account copy user@laptop. Lähettäjä toimittaa väliaikaisen vastaanottajan, kun kohteessa ei ole sellaista asennettuna, joten vanhemmat Omarchy-koneet voivat vastaanottaa tilejä ilman päivitystä. Asennetut vastaanottajat ovat etusijalla. Tämä kopioi kaikki Claude-, Codex- ja Grok-tilaukset; lisää palveluntarjoajien nimiä valitaksesi ne, kuten komennossa omarchy agent account copy laptop claude. Tilien nimet ja komentotunnukset vastaavat lähdettä, mukaan lukien tilit, jotka ovat jo kohteessa. Kohteen toisiinsa liittymättömät tilit saavat numeropäätteen, jos niiden nimet ovat ristiriidassa, ja asetukset, taidot, laajennukset ja keskusteluhistoria pysyvät paikallisina jokaisella koneella.
Kohteen olemassa olevat tunnistetiedot säilytetään. Lähdetili, joka on jo kirjautunut sinne, saa nimensä synkronoitua korvaamatta sen tunnistetietoja; muut tilit lisätään sen rinnalle. Korvataksesi vastaavien tilien tallennetut tunnistetiedot, käytä komentoa omarchy agent account copy --replace laptop claude suljettuasi kyseisen tilin istunnot kohteessa. Uusi kohde saa myös lähteen aktiivisen tilin ja vaihtamisasetukset; vakiintunut kohde säilyttää omansa.
Tunnistetiedot kulkevat SSH:n kautta ja tallennetaan yksityisiin tiedostoihin kohteessa, joten kopioi vain koneille, joihin luotat. Tämä on kertakopio, ei jatkuva synkronointi. Toinen kone voi vaihtaa Codexin päivitystokeneita, jolloin kopioitu kirjautuminen tarvitsee uusimista; erilliset kirjautumiset ovat edelleen luotettavin valinta samanaikaiseen käyttöön useilla koneilla. Katso Codexin tilitodennusohjeet.
Yksi tili palveluntarjoajaa kohti on aktiivinen, ja jokainen uusi istunto alkaa senä: cx, cy, tavallinen claude, codex tai grok, kaikki omarchy agent -komennon kautta käynnistetty sekä skriptit tai editorit, jotka löytävät CLI:n PATH-muuttujasta. Vaihda komennolla omarchy agent account use work (ja takaisin komennolla omarchy agent account use main) tai paneelissa painamalla tilin numeroa ja sitten Enter (tai napsauttamalla sen Use-painiketta). Jo käynnissä olevat istunnot pysyvät tilillä, jolla ne alkoivat. Keskusteluhistoria, asetukset, taidot ja laajennukset jaetaan tilien kesken, joten claude --continue samassa kansiossa jatkaa siitä, mihin jäit uudella tilillä.
Kun tilejä on useampi kuin yksi, paneeli näyttää jokaisen tilin rajoitukset rinnakkain aktiivinen merkittynä. Oletuksena Omarchy ilmoittaa sinulle, kun aktiivinen tili ylittää 95 % rajoituksesta, ja ilmoituksen napsauttaminen vaihtaa tiliin, jolla on eniten liikkumavaraa. Vie osoitin tilin rivin päälle paneelissa ja napsauta Use-painikkeen viereen ilmestyvää Autoswitch-painiketta (tai paina m), tai suorita omarchy agent account mode auto, jotta se vaihtaa itsestään; kun se on päällä, Autoswitch ottaa Use-painikkeen paikan, ja sen napsauttaminen uudelleen palaa ilmoittamiseen. Lisää numero muuttaaksesi kynnystä, kuten komennossa omarchy agent account mode auto 90. Jos jokainen tili on kynnyksen yli, kuulet siitä kerran yhdessä sen kanssa, mikä tili vapautuu ensimmäisenä. Kun aktiivinen tili on 15 pisteen sisällä kynnyksestään (oletuksella 80 %), sen rajoitukset tarkistetaan kolmen minuutin välein 15 minuutin sijasta.
omarchy agent account list näyttää jokaisen tilin ja sen uusimmat rajoitukset, omarchy agent account remove work unohtaa yhden ja omarchy agent account rename primary Hey nimeää yhden uudelleen (tai napsauta tilin nimeä paneelissa). Nämä komennot toimivat oletusagenttisi tileillä; päästäksesi toiseen palveluntarjoajaan, nimeä se ensin, kuten komennossa omarchy agent account use codex side. Kirjautuminen, joka sinulla jo oli kansiossa ~/.claude tai ~/.codex, on Main-tili ja pysyy siellä, missä se on. Tili, joka on ollut käyttämättä yli noin kahdeksan tuntia, voi näyttää tekstin Sign-in required; napsauta sitä kirjautuaksesi kyseiseen tiliin uudelleen suoraan paneelissa, tai aloita istunto sillä, mikä päivittää kirjautumisen itsestään. MCP-palvelimet, jotka sinulla oli tilin lisäämishetkellä, tulevat sen mukana, mutta ne, jotka lisäät myöhemmin komennolla claude mcp add, saavuttavat vain tilin, johon lisäsit ne. Claude Desktop ja työkalut, jotka on määritetty CLI-binäärin absoluuttisella polulla, eivät seuraa vaihtoa. Nimenomainen CLAUDE_CONFIG_DIR, CODEX_HOME tai GROK_HOME on etusijalla valittuun tiliin nähden.
Kaatumisdiagnoosi
Omarchy tarkkailee systemd-coredumpia prosessien kaatumisten varalta. Kun jokin segfaulttaa, saat “Prosessi kaatui” -ilmoituksen - napsauta sitä, ja kaatuminen annetaan oletusagentillesi yhdessä Omarchyn diagnose-crash-taidon kanssa, joka opastaa agentin selvittämään tosiasiat core dumpista ja päättämään, kannattaako kaatuminen raportoida ylävirtaan. Voit myös suorittaa sen käsin mitä tahansa coredumpctl list -tuloksen PID:tä vasten komennolla omarchy agent crash <pid>.
Tarkkailu on oletuksena päällä. Kytke se pois päältä kohdasta Trigger > Toggle > Crash Capture (tai komennolla omarchy toggle crash-capture), ja ilmoitukset loppuvat; omarchy agent crash <pid> toimii silti käsin.
Kaatumiset voidaan myös hiljentää yksi ohjelma kerrallaan, minkä diagnoosi tarjoaa sinulle lopussa. omarchy crash mute hyprland lopettaa ilmoitukset vain kyseisestä ohjelmasta, omarchy crash mute hyprland off tuo ne takaisin, ja omarchy crash mute yksinään luettelee, mitä olet mykistänyt. Se hyväksyy binäärin polun yhtä mielellään kuin sen nimen, joten omarchy crash mute /usr/bin/hyprland tekee saman asian. Laita lainausmerkkeihin nimi, jossa on välilyönti, kuten komennossa omarchy crash mute 'Some App'. Kaikki muu ilmoittaa edelleen, ja mykistetty ohjelma kaatuu edelleen - tämä piilottaa muistutuksen, se ei korjaa mitään.
Työpöytäsovellukset
Asenna > Tekoäly -valikko sisältää myös muutaman graafisen tekoälysovelluksen: ChatGPT-työpöytäsovelluksen, Claude-työpöytäsovelluksen (Anthropicin Linux-beta, jossa on Chat-, Cowork- ja Claude Code -välilehdet), Grok Botin xAI:n mallien kanssa keskusteluun, Hermes Desktopin, OpenClaw’n, Perplexity-työpöytäsovelluksen ja T3 Coden. Grok Bot on työpöytäkeskustelusovellus. Koodausagentti on grok-komento.
Hermes Desktop on se, josta kannattaa tietää, koska koneella on yksi Hermes, ja se kuuluu sovellukselle: Hermes asennetaan aina vain sovelluksen kautta, ja oletusagentin ajama hermes-komento on sovelluksen oma. Hermesin valitseminen oletusagentiksi asentaa saman asian kuin Asenna > Tekoäly -merkintä: paketin ja Hermesin ajonaikaisen ympäristön kansioon ~/.hermes, jonka Hermesin oma asennusohjelma määrittää ja joka kestää ensimmäisellä kerralla muutaman minuutin. Kyseinen ajonaikainen ympäristö on se yksi Hermes, jota terminaalin hermes-komento, oletusagentti ja sovellus kaikki käyttävät, ja se päivittää itsensä komennolla hermes update sen sijaan, että odottaisi Omarchy-julkaisua. Sen asentaminen antaa Hermesille myös Omarchy-teeman skiniksi nimeltä omarchy, jota jokainen Hermes-pinta seuraa vaihtaessasi teemoja; valitse toinen Hermesin Appearance-asetuksista tai komennolla /skin, jos et halua sen tekevän niin, ja Omarchy jättää kyseisen valinnan rauhaan. Sovelluksen poistaminen kohdasta Poista > Tekoäly sulkee Hermesin ensin, yhdyskäytävä mukaan lukien, vie kyseisen ajonaikaisen ympäristön mukanaan ja säilyttää keskustelusi, muistisi ja taidot, jotka Hermes kirjoitti itselleen, ellet toisin käske: se kysyy, oletuksena ei, pitäisikö myös kyseisten tietojen ja yhteysasetustesi poistua.
OpenClaw’n työpöytäkokemus on sen Control UI, joka avautuu verkkosovelluksena oman paikallisen yhdyskäytävänsä tukemana. OpenClaw sijaitsee kansiossa ~/.openclaw ja päivittää itsensä: käytä Control UI:n “Update Gateway” -painiketta tai suorita openclaw update, ja yhdyskäytävä käynnistyy uudelleen uudella versiolla. Omarchy valitsee vain julkaisun, josta uusi asennus alkaa. OpenClaw’n poistaminen kohdasta Poista > Tekoäly vie yhdyskäytäväpalvelun ja sovelluksen mukanaan ja kysyy sitten, pitäisikö myös kansion ~/.openclaw poistua, koska se sisältää keskustelusi ja tunnistetietosi OpenClaw’n itsensä ja sen lataamien laajennusten ajonaikaisten ympäristöjen rinnalla; oletus säilyttää sen, ja OpenClaw’n asentaminen uudelleen ottaa sen takaisin käyttöön.
T3 Code toimii sen virallisesta AppImage-julkaisusta kansiossa ~/.local/share/t3code paketin sijaan, joten se päivittää itsensä. Sen asentaminen kysyy, aloitetaanko Stable- vai Nightly-kanavalta; vaihda myöhemmin T3 Coden asetuksissa. Säikeesi ja asetuksesi sijaitsevat kansiossa ~/.t3, ja T3 Coden poistaminen kohdasta Poista > Tekoäly vie ne mukanaan.
Paikalliset LLM:t
Omarchy suosittelee kahta tapaa ajaa paikallisia LLM-malleja: LM Studiota ja Ollamaa. LM Studio tarjoaa graafisen käyttöliittymän avoimen painotuksen mallien etsimiseen, asentamiseen ja ajamiseen. Se on erinomainen tapa päästä helposti alkuun. Ollama tarjoaa CLI:n samojen asioiden tekemiseen samankaltaisesti. Mutta jos paikalliset mallit ovat sinulle uusia, aloittaisin LM Studiosta. Voit asentaa kumman tahansa Omarchy-valikon kohdasta Asenna > Tekoäly.
Omarchy Skill
Agenttitaidot auttavat tekoälyä käyttämään tiettyjä työkaluja tietyllä tavalla, ja Omarchyn mukana tulee oletustaito järjestelmän räätälöintiin. Kuten Hyprland-määrityksesi säätäminen, palkin muuttaminen tai jopa uuden teeman luominen tyhjästä. Se on symbolisesti linkitetty taitokansioihin Claude Codelle (~/.claude/skills), Codexille (~/.codex/skills), Pi:lle (~/.pi/agent/skills), Antigravitylle (~/.gemini/config/skills), Hermesille (~/.hermes/skills ja jokainen ~/.hermes/profiles/*/skills) sekä yleiseen sijaintiin ~/.agents/skills, joten useimmat harness-ohjelmat poimivat sen automaattisesti.
Mutta sinun kannattaa pitää tätä taitoa kokeellisena. Eri mallit käyttävät sitä erilaisin vaikutuksin. Se kannattaa ajaa ensin suunnitelmatilassa, jotta sinulla on käsitys siitä, mitä agentti haluaisi muuttaa. Ja ole sitten valmis perumaan muutokset tai jopa suorittamaan omarchy reinstall configs, jos agentti sotkee kaiken.