Rokasgrāmata
AI
Omarchy iekļauj tālāk norādīto kodēšanas aģentu palaidējus, neizvēloties noklusējumu jūsu vietā. Palaidiet komandu, lai pirmajā lietošanas reizē instalētu tās CLI, pēc tam autentificējieties, kad tiek prasīts. Hermes ir izņēmums: pirmajā lietošanas reizē tam nekas netiek instalēts, un tā izvēle instalē Hermes Desktop, kā tālāk skaidro Desktop apps.
| Komanda | Aģents |
|---|---|
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 no Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff, Codebuff bezmaksas, ar reklāmām atbalstītais kodēšanas aģents |
grok |
Grok Build no xAI |
hermes |
Hermes, Nous Research aģents |
kilo |
Kilo, uz OpenCode balstīts kodēšanas aģents |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code, MiniMax kodēšanas aģents |
muse |
Muse Code, Meta kodēšanas aģents |
omp |
Oh My Pi |
ori |
Ori, OpenRouter ietvars |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code, Alibaba kodēšanas aģents |
ori ir savādnieks: tas darbina pārējos ietvarus pret visu OpenRouter modeļu katalogu, tāpēc ori claude, ori codex vai ori opencode palaiž šos aģentus ar jebkuru modeli, uz kuru tos norādāt, un ori code ir paša Ori aģents.
Aģentu instalēšana un atjaunināšana
Izņemot Hermes, šie aģenti izmanto mise slinko instalēšanu: pirmā palaišana instalē CLI, un vēlākās palaišanas to izmanto atkārtoti. mise arī ne biežāk kā reizi četrās stundās pārbauda, vai instalētam aģentam ir jauns laidiens, tieši pirms tā palaišanas vai fonā čaulas uzvednē. Ja šī atjaunināšana neizdodas vai esat bezsaistē, darbojas instalētā versija. omarchy update atjaunina instalētos aģentus kopā ar pārējo Omarchy, un mup atjaunina tikai mise pārvaldītos rīkus.
Paša aģenta atjauninātājs, piemēram, claude update, codex update vai atjaunināšanas poga lietotnē, neatjaunina mise pārvaldīto instalāciju. codex update neizdodas, un claude update var ziņot par panākumiem, vienlaikus instalējot atsevišķu kopiju, ko mise neizseko. Ja labprātāk izmantotu aģenta vietējo instalētāju un atjauninātāju, pievienojiet to disable_tools; skatiet Iepriekš instalētie CLI rīki.
Lai instalētu visus konfigurētos slinkos rīkus, pirms tie jums vajadzīgi, palaidiet mise install --include-lazy. Tas ietver arī citus Omarchy noklusējuma CLI rīkus, kā arī aģentus. Par viena rīka instalēšanu vai savas instalācijas izmantošanu skatiet Iepriekš instalētie CLI rīki.
grok tiek instalēts, izmantojot mise pirmās puses grok pakotni, tāpat kā claude un codex. Palaidiet grok vai izvēlieties to sadaļā Setup > Defaults > Agent. Izlaidiet curl | bash instalētāju vietnē x.ai. Šis ceļš ievieto otru kopiju ~/.grok/bin, pievieno to PATH sākumā un pārraksta Omarchy iesaiņojumu.
dsh atver savu pārlūka saskarni adresē 127.0.0.1:3080, ar palaišanas direktoriju kā noklusējuma darbvietu. Tā pārlūka saskarne nepieņem sākuma uzvedni, tāpēc omarchy agent prompt to atver ar uzvedni jūsu starpliktuvē, lai to ielīmētu. Omarchy to palaiž ar DeepSeek iepriekš iestatīto atļauju kopu bez apstiprināšanas. DeepSeek Harness augšupielādē sesiju žurnālus DeepSeek, kad izmantojat tā oficiālo modeļa API; izslēdziet to tā pārlūka saskarnē sadaļā Settings > General > Upload Session Log. Atsauksmes, ko tam sūtāt, tiek augšupielādētas kopā ar sesiju, ja vien to nepalaižat ar DSH_TELEMETRY_MODE=DISABLED.
Noklusējuma aģents
Izvēlieties savu noklusējuma aģentu ar omarchy default agent <name> vai sadaļā Setup > Defaults > Agent Omarchy izvēlnē (Super + Space). Ja aģents vēl nav instalēts, tā izvēle to vispirms instalē. Jauns Omarchy aicinās jūs izdarīt šo izvēli ar vienreizēju paziņojumu.
Claude izvēle arī mēģina iestatīt tā pārlūka paplašinājumu pārlūkiem Chromium, Chrome, Brave, Brave Origin un Edge. Paplašinājuma iestatīšana attiecas uz visiem lietotājiem un var prasīt jūsu sistēmas paroli; paplašinājuma instalēšanas atcelšana vai neveiksme joprojām izvēlas un palaiž Claude. Restartējiet pārlūku, iespējojiet paplašinājumu, ja tiek prasīts, un pierakstieties Claude, lai pabeigtu tā savienošanu. Palaidiet /chrome Claude, lai pārbaudītu savienojumu. Firefox un Zen šo paplašinājumu neatbalsta. Ja Claude jau bija jūsu noklusējums, pirms šī iestatīšana tika pievienota, izvēlieties to vēlreiz, lai instalētu paplašinājumu.
Kad esat izvēlējies, Super + Shift + Ctrl + A palaiž noklusējuma aģentu īpašā termināļa logā (vai atver izvēlētāju, ja vēl neesat izvēlējies). Varat to arī palaist tieši uzdevumā ar omarchy agent prompt "Review this project". Freebuff un DeepSeek Harness nepieņem sākuma uzvedni, tāpēc tie tā vietā atveras ar uzvedni jūsu starpliktuvē, lai to ielīmētu. Šādi palaisti aģenti darbojas bez uzraudzības savos attiecīgajos režīmos, kuros tie neapstājas, lai jautātu, tāpēc esiet gatavi, ka tie patiešām darīs lietas! MiniMax Code tā interaktīvajām sesijām šāda režīma nav, tāpēc tas prasa atļaujas kā parasti. Un, tā kā aģenti atsakās atcerēties uzticēšanos jūsu mājas direktorijam, palaišanas no $HOME tā vietā sākas ~/Work.
Ir arī termināļa saīsnes: a palaiž noklusējuma aģentu iekļauti pašreizējā terminālī, savukārt c, cx un cy palaiž OpenCode, Claude Code un Codex tieši (atkal to automātiskās apstiprināšanas režīmos). Motīvu maiņa arī sinhronizējas ar aģentiem: Claude Code, Pi, OpenCode un Hermes (kad Omarchy to ir instalējis) visi seko līdzi, kad pārslēdzat Omarchy motīvu.
Aģentu panelis
Augšējā joslā ir aģentu ikona. Pirms esat iestatījis aģentu, tās panelis soli pa solim palīdz pierakstīties Claude, Codex vai Grok, un pirmais kļūst par jūsu noklusējuma aģentu. Pēc tam panelis ievieto katru abonementu vienā lapā: katru aģentu un kontu ar tā plānu, mērītāju katram tā 5 stundu sesijas un nedēļas limitam ar laiku līdz tā atiestatīšanai (novietojiet kursoru, lai redzētu precīzu procentu), vai atlikušo priekšapmaksas atlikumu, zem rindas, kas rotē cauri tam, ko esat izmantojis visos tajos, piemēram, marķieriem šonedēļ un jūsu visvairāk izmantotajam modelim. Sadaļā Make something tas piedāvā sākuma uzvednes jaunam motīvam, spraudnim vai lietotnei, kas nodod uzdevumu jūsu noklusējuma aģentam. Lietotnes tiek veidotas tā, kā tiek veidotas paša Omarchy Hype, Monologue un Omacut, C++ un Qt Quick, ievērojot omarchy-app aģenta prasmi, un tām nepieciešamais kompilators un Qt daļas tiek instalētas līdzi. Claude Code, Codex, Grok, Kimi, Cursor un tā Grok Bot kvota, GitHub Copilot, Muse, Antigravity, Kimchi un Devin ir aptverti uzreiz ar to limitiem, un Hermes, Mistral Vibe un Qwen Code rāda savas sesijas un marķierus, kad esat tos izmantojis. Arī pakalpojumu sniedzēju plāni un atslēgas, ko izmantojat caur pi, omp vai opencode, parādās: OpenCode Zen un Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan un Synthetic ar to limitiem; Fireworks, OpenRouter un DeepSeek ar to priekšapmaksas atlikumiem; un modeļi, ko darbināt uz savas aparatūras, sadaļā Local models. Katrs aģents tiek skaitīts vienreiz, pie tā, kas par to izraksta rēķinu, lai arī caur cik ietvariem to darbinātu.
Noklikšķiniet ar kreiso pogu uz joslas ikonas, lai atvērtu paneli, ar labo pogu, lai palaistu noklusējuma aģentu. Aiz tā esošie lietojuma ieraksti tiek atjaunoti ik pēc 15 minūtēm ar omarchy agent usage-update, un panelis var pat apvienot lietojumu no jūsu citām mašīnām, izmantojot sinhronizētu mapi. Pilnus iestatījumus skatiet README sadaļā $OMARCHY_PATH/shell/plugins/agents/.
Vairāki abonementi
Ja maksājat par vairāk nekā vienu Claude, Codex vai Grok plānu - piemēram, personīgo Max un darba plānu - , Omarchy var tos visus turēt pierakstītus un pārvietoties starp tiem. Pievienojiet abonementu ar + aģentu panelī, kas jūs turpat soli pa solim izved cauri procesam, vai ar omarchy agent account add claude Work (vai codex, vai grok). Tas instalē CLI, ja tā trūkst. Pirmā konta pierakstīšanās pakalpojumu sniedzējam notiek caur jūsu parasto pārlūku, tieši tur, kur CLI vienmēr meklē. Katra nākamā pierakstīšanās notiek caur privātu logu, lai konts, kurā jūsu pārlūks jau ir pierakstījies, netiktu paņemts kļūdas pēc; pierakstieties tur kā kontā, ko pievienojat, un vispirms aizveriet jebkuru privāto logu, kas jums jau ir atvērts. Nekad neizrakstieties no CLI, lai to darītu: izrakstīšanās atsauc saglabāto pierakstīšanos, un šis konts būtu jāpievieno vēlreiz.
Lai kopētu savas abonementu pierakstīšanās uz citu Omarchy mašīnu caur SSH, palaidiet omarchy agent account copy user@laptop. Sūtītājs nodrošina pagaidu saņēmēju, kad galamērķim tāda nav instalēta, tāpēc vecākas Omarchy mašīnas var saņemt kontus bez atjauninājuma. Instalētie saņēmēji ir prioritāri. Tas kopē visus Claude, Codex un Grok abonementus; pievienojiet pakalpojumu sniedzēju nosaukumus, lai tos atlasītu, piemēram, omarchy agent account copy laptop claude. Kontu nosaukumi un komandu ID atbilst avotam, tostarp kontiem, kas jau ir galamērķī. Nesaistīti galamērķa konti saņem skaitlisku piedēkli, ja to nosaukumi konfliktē, un iestatījumi, prasmes, spraudņi un sarunu vēsture paliek lokāli katrai mašīnai.
Esošie galamērķa akreditācijas dati tiek saglabāti. Avota kontam, kas tur jau ir pierakstījies, tā nosaukums tiek sinhronizēts, neaizstājot tā akreditācijas datus; pārējie konti tiek pievienoti tam līdzās. Lai aizstātu saglabātos akreditācijas datus atbilstošiem kontiem, izmantojiet omarchy agent account copy --replace laptop claude pēc šī konta sesiju aizvēršanas galamērķī. Jauns galamērķis saņem arī avota aktīvo kontu un pārslēgšanās preferences; izveidots galamērķis saglabā savas.
Akreditācijas dati ceļo caur SSH un tiek glabāti privātos failos galamērķī, tāpēc kopējiet tikai uz mašīnām, kurām uzticaties. Šī ir vienreizēja kopija, nevis notiekoša sinhronizācija. Codex atsvaidzināšanas marķierus var rotēt cita mašīna, atstājot kopētu pierakstīšanos atjaunošanas vajadzībā; atsevišķas pierakstīšanās joprojām ir visuzticamākā izvēle vienlaicīgai lietošanai vairākās mašīnās. Skatiet Codex konta autentifikācijas norādījumus.
Viens konts katram pakalpojumu sniedzējam ir aktīvs, un katra jauna sesija sākas kā tas: cx, cy, vienkāršs claude, codex vai grok, jebkas, kas palaists caur omarchy agent, un skripti vai redaktori, kas atrod CLI PATH. Pārslēdzieties ar omarchy agent account use work (un atpakaļ ar omarchy agent account use main) vai panelī, nospiežot konta numuru un pēc tam Enter (vai noklikšķinot uz tā pogas Use). Sesijas, kas jau darbojas, paliek kontā, ar kuru tās sākās. Sarunu vēsture, iestatījumi, prasmes un spraudņi tiek koplietoti starp kontiem, tāpēc claude --continue tajā pašā mapē turpina tur, kur apstājāties, jaunajā kontā.
Ar vairāk nekā vienu kontu panelis rāda katra konta limitus blakus, ar aktīvo atzīmētu. Pēc noklusējuma Omarchy paziņo jums, kad aktīvais konts pārsniedz 95% no limita, un paziņojuma noklikšķināšana pārslēdzas uz kontu ar vislielāko rezervi. Novietojiet kursoru virs konta rindas panelī un noklikšķiniet uz Autoswitch, kas parādās blakus Use (vai nospiediet m), vai palaidiet omarchy agent account mode auto, lai tas pārslēgtos pats; kamēr tas ir ieslēgts, Autoswitch ieņem Use vietu, un tā atkārtota noklikšķināšana atgriežas pie paziņošanas. Pievienojiet skaitli, lai mainītu slieksni, piemēram, omarchy agent account mode auto 90. Ja katrs konts ir virs sliekšņa, jūs par to dzirdēsiet vienreiz, kopā ar to, kurš konts atbrīvojas pirmais. Kamēr aktīvais konts ir 15 punktu robežās no tā sliekšņa (80% pēc noklusējuma), tā limiti tiek pārbaudīti ik pēc trim minūtēm, nevis ik pēc 15.
omarchy agent account list rāda katru kontu un tā jaunākos limitus, omarchy agent account remove work aizmirst vienu, un omarchy agent account rename primary Hey pārdēvē vienu (vai noklikšķiniet uz konta nosaukuma panelī). Šīs komandas darbojas ar jūsu noklusējuma aģenta kontiem; lai sasniegtu otru pakalpojumu sniedzēju, vispirms nosauciet to, piemēram, omarchy agent account use codex side. Pierakstīšanās, kas jums jau bija ~/.claude vai ~/.codex, ir Main konts un paliek tur, kur tā ir. Konts, kas atstāts neizmantots ilgāk nekā aptuveni astoņas stundas, var rādīt Sign-in required; noklikšķiniet uz tā, lai pierakstītu šo kontu vēlreiz tieši panelī, vai sāciet tajā sesiju, kas pierakstīšanos atsvaidzina pati. MCP serveri, kas jums bija, kad konts tika pievienots, nāk tam līdzi, bet tie, ko pievienojat vēlāk ar claude mcp add, sasniedz tikai kontu, kurā tos pievienojāt. Claude Desktop un rīki, kas konfigurēti ar absolūtu ceļu uz CLI bināro failu, pārslēgšanai neseko. Skaidri norādīts CLAUDE_CONFIG_DIR, CODEX_HOME vai GROK_HOME ir prioritārs pār izvēlēto kontu.
Avāriju diagnostika
Omarchy vēro systemd-coredump, meklējot procesu avārijas. Kad kaut kas segfaulto, jūs saņemsiet paziņojumu “Process crashed” - noklikšķiniet uz tā, un avārija tiek nodota jūsu noklusējuma aģentam kopā ar Omarchy diagnose-crash prasmi, kas soli pa solim ved aģentu cauri faktu noskaidrošanai no kodola izgāztuves un izlemšanai, vai par avāriju ir vērts ziņot augšup. Varat to arī palaist manuāli pret jebkuru PID no coredumpctl list ar omarchy agent crash <pid>.
Vērošana pēc noklusējuma ir ieslēgta. Izslēdziet to sadaļā Trigger > Toggle > Crash Capture (vai ar omarchy toggle crash-capture), un paziņojumi apstājas; omarchy agent crash <pid> joprojām darbojas manuāli.
Avārijas var arī apklusināt pa vienai programmai, ko diagnostika jums piedāvā beigās. omarchy crash mute hyprland aptur paziņojumus tikai šai programmai, omarchy crash mute hyprland off tos atgriež, un omarchy crash mute pats par sevi uzskaita, ko esat apklusinājis. Tas pieņem binārā faila ceļu tikpat labprāt kā tā nosaukumu, tāpēc omarchy crash mute /usr/bin/hyprland dara to pašu. Lieciet nosaukumu ar atstarpi pēdiņās, piemēram, omarchy crash mute 'Some App'. Viss pārējais joprojām paziņo, un apklusinātā programma joprojām avarē - tas slēpj atgādinājumu, tas neko nelabo.
Darbvirsmas lietotnes
Izvēlnē Install > AI ir arī dažas grafiskas AI lietotnes: ChatGPT darbvirsmas lietotne, Claude darbvirsmas lietotne (Anthropic Linux beta, ar Chat, Cowork un Claude Code cilnēm), Grok Bot tērzēšanai ar xAI modeļiem, Hermes Desktop, OpenClaw, Perplexity darbvirsmas lietotne un T3 Code. Grok Bot ir darbvirsmas tērzēšanas lietotne. Kodēšanas aģents ir komanda grok.
Hermes Desktop ir tā, par kuru jāzina, jo mašīnā ir viens Hermes, un tas ir lietotnes: Hermes vienmēr tiek instalēts tikai caur lietotni, un komanda hermes, ko palaiž noklusējuma aģents, ir lietotnes. Hermes izvēle par noklusējuma aģentu instalē to pašu, ko ieraksts Install > AI: pakotni un Hermes izpildlaiku zem ~/.hermes, ko iestata paša Hermes instalētājs, kas pirmajā reizē aizņem dažas minūtes. Šis izpildlaiks ir tas viens Hermes, ko izmanto termināļa komanda hermes, noklusējuma aģents un lietotne, un tas atjauninās pats ar hermes update, nevis gaida Omarchy laidienu. Tā instalēšana arī nodod Hermes Omarchy motīvu kā ādu ar nosaukumu omarchy, kurai seko katra Hermes virsma, kad pārslēdzat motīvus; izvēlieties citu Hermes Appearance iestatījumos vai ar /skin, ja labprātāk tā nebūtu, un Omarchy šo izvēli atstāj mierā. Lietotnes noņemšana sadaļā Remove > AI vispirms aizver Hermes, tostarp vārteju, paņem šo izpildlaiku līdzi un saglabā jūsu tērzēšanas, atmiņas un prasmes, ko Hermes pats sev uzrakstīja, ja vien neliekat citādi: tā jautā, pēc noklusējuma atbildot nē, vai arī šiem datiem un jūsu savienojuma iestatījumiem būtu jāiet līdzi.
OpenClaw darbvirsmas pieredze ir tā Control UI, kas atveras kā tīmekļa lietotne, ko atbalsta tā paša lokālā vārteja. OpenClaw dzīvo ~/.openclaw un atjauninās pats: izmantojiet Control UI pogu “Update Gateway” vai palaidiet openclaw update, un vārteja restartējas jaunajā versijā. Omarchy izvēlas tikai laidienu, no kura sākas jauna instalācija. OpenClaw noņemšana sadaļā Remove > AI paņem vārtejas pakalpojumu un lietotni līdzi un pēc tam jautā, vai arī ~/.openclaw būtu jāiet līdzi, jo tur glabājas jūsu tērzēšanas un akreditācijas dati līdzās pašam OpenClaw un spraudņu izpildlaikiem, ko tas lejupielādē; noklusējums to saglabā, un OpenClaw atkārtota instalēšana to atkal paņem.
T3 Code darbojas no tā oficiālā AppImage laidiena ~/.local/share/t3code, nevis no pakotnes, tāpēc tas atjauninās pats. Tā instalēšana jautā, vai sākt Stable vai Nightly kanālā; pārslēdzieties vēlāk T3 Code iestatījumos. Jūsu pavedieni un iestatījumi dzīvo ~/.t3, un T3 Code noņemšana sadaļā Remove > AI tos paņem līdzi.
Lokālie LLM
Omarchy iesaka divus veidus, kā darbināt lokālos LLM modeļus: LM Studio un Ollama. LM Studio nodrošina GUI saskarni atvērtā svara modeļu atrašanai, instalēšanai un darbināšanai. Tas ir lielisks veids, kā viegli sākt. Ollama piedāvā CLI, lai darītu to līdzīgi. Bet, ja lokālajos modeļos esat jaunpienācējs, es sāktu ar LM Studio. Jebkuru no tiem varat instalēt sadaļā Install > AI Omarchy izvēlnē.
Omarchy prasme
Aģentu prasmes palīdz AI izmantot konkrētus rīkus konkrētā veidā, un Omarchy tiek piegādāts ar noklusējuma prasmi sistēmas pielāgošanai. Piemēram, jūsu Hyprland konfigurācijas pielāgošanai, joslas regulēšanai vai pat jauna motīva izveidei no nulles. Tā ir simboliski saistīta prasmju direktorijos Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills un katrā ~/.hermes/profiles/*/skills) un vispārīgajā atrašanās vietā ~/.agents/skills, tāpēc lielākā daļa ietvaru to paņem automātiski.
Bet jums šī prasme jāuzskata par eksperimentālu. Dažādi modeļi to izmantos ar atšķirīgu efektu. Vislabāk vispirms darboties plāna režīmā, lai jums būtu priekšstats par to, ko aģents vēlētos mainīt. Un pēc tam esiet gatavi atsaukt izmaiņas vai pat izsaukt omarchy reinstall configs, ja aģents visu sajauc.