Ruka hadi maudhui
Chapters
  1. Karibu Omarchy!
  2. Kuanza
  3. Kutoka Mac au Windows
  4. Urambazaji
  5. Upau wa Juu
  6. Mandhari
  7. Vibonye vya Haraka
  8. Ubao wa Kunakili Uliounganishwa & Historia
  9. Vikumbusho
  10. Ilani
  11. Uchimbaji wa Maandishi na Imla
  12. Picha za Skrini na Kurekodi
  13. Vigeuzi, Kutotenda & Kiokoa Skrini
  14. Omarchy CLI
  15. Terminali
  16. Neovim
  17. AI
  18. Zana za Uendelezaji
  19. Zana za Shell
  20. Vitendakazi vya Shell
  21. TUIs
  22. GUIs
  23. Vivinjari
  24. Programu/huduma za kibiashara
  25. Programu za Wavuti
  26. Michezo
  27. Kujaza PDF
  28. Windows VM
  29. Vifurushi Vingine
  30. Masasisho
  31. Dotfiles
  32. Programu-jalizi za Shell
  33. Monita
  34. Kibodi, Kipanya, Trackpad
  35. Mtandao
  36. Usingizi wa mfumo
  37. Uthibitishaji wa vifaa
  38. Fonti
  39. Mandhari za Nyuma
  40. Kidokezo (Prompt)
  41. Chapa
  42. Marekebisho ya kawaida
  43. Kutengeneza mandhari yako mwenyewe
  44. Usaidizi wa Mac
  45. Kutatua matatizo
  46. FAQ
  47. Picha za mfumo
  48. Usalama
  49. Omarchy kwenye...
  50. Usakinishaji wa Dual Boot
  51. Usakinishaji Usiosimamiwa

Mwongozo

AI

Omarchy inajumuisha vizindua vya mawakala wa kuandika msimbo walio hapa chini bila kukuchagulia chaguo-msingi. Endesha amri ili kusakinisha CLI yake mara ya kwanza unapoitumia, kisha thibitisha utambulisho unapoombwa. Hermes ndiye tofauti: hakuna kinachosakinishwa kwa ajili yake mara ya kwanza, na kuichagua kunasakinisha Hermes Desktop, kama Programu za eneo-kazi hapa chini zinavyoeleza.

Amri Wakala
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 kutoka Cognition
dsh DeepSeek Harness
freebuff Freebuff, wakala wa Codebuff wa bure, unaoungwa mkono na matangazo, wa kuandika msimbo
grok Grok Build kutoka xAI
hermes Hermes, wakala wa Nous Research
kilo Kilo, wakala wa kuandika msimbo unaotegemea OpenCode
kimi Kimi Code
kiro-cli Kiro CLI
mcode MiniMax Code, wakala wa MiniMax wa kuandika msimbo
muse Muse Code, wakala wa Meta wa kuandika msimbo
omp Oh My Pi
ori Ori, harness ya OpenRouter
pi Pi ya Mario Zechner
qwen Qwen Code, wakala wa Alibaba wa kuandika msimbo

ori ndiye wa tofauti: huendesha harness nyingine dhidi ya katalogi nzima ya modeli za OpenRouter, kwa hiyo ori claude, ori codex, au ori opencode huanzisha mawakala hao kwenye modeli yoyote unayowaelekeza, na ori code ni wakala wa Ori mwenyewe.

Kusakinisha na kusasisha mawakala

Isipokuwa Hermes, mawakala hawa hutumia usakinishaji wa uvivu wa mise: uzinduzi wa kwanza husakinisha CLI, na uzinduzi wa baadaye huutumia tena. mise pia hukagua wakala aliyesakinishwa kama kuna toleo jipya mara moja tu kila baada ya saa nne, mara tu kabla ya kuanza au chinichini kwenye kidokezo cha shell. Ikiwa sasisho hilo litashindwa au hauko mtandaoni, toleo lililosakinishwa huendeshwa. omarchy update husasisha mawakala waliosakinishwa pamoja na Omarchy yote, na mup husasisha zana zinazosimamiwa na mise pekee.

Kisasishaji cha wakala mwenyewe, kama claude update, codex update, au kitufe cha kusasisha katika programu, hakisasishi usakinishaji unaosimamiwa na mise. codex update hushindwa, na claude update inaweza kuripoti mafanikio huku ikisakinisha nakala tofauti ambayo mise haifuatilii. Ikiwa ungependa kutumia kisakinishaji na kisasishaji asilia cha wakala, kiongeze kwenye disable_tools; angalia Zana za CLI zilizosakinishwa mapema.

Ili kusakinisha zana zote za uvivu zilizosanidiwa kabla ya kuzihitaji, endesha mise install --include-lazy. Hii inajumuisha zana nyingine chaguo-msingi za CLI za Omarchy pamoja na mawakala. Angalia Zana za CLI zilizosakinishwa mapema kwa kusakinisha zana moja au kutumia usakinishaji wako mwenyewe.

grok imesakinishwa kupitia kifurushi cha kwanza cha mise cha grok, kwa njia ileile kama claude na codex. Endesha grok, au ichague chini ya Setup > Defaults > Agent. Ruka kisakinishaji cha curl | bash kwenye x.ai. Njia hiyo huweka nakala ya pili katika ~/.grok/bin, huiweka mbele kwenye PATH, na kubatilisha wrapper ya Omarchy.

dsh hufungua kiolesura chake cha kivinjari kwenye 127.0.0.1:3080, na saraka ya uzinduzi kama nafasi yake chaguo-msingi ya kazi. Kiolesura chake cha kivinjari hakichukui kidokezo cha kuanzia, kwa hiyo omarchy agent prompt hukifungua na kidokezo kwenye ubao wako wa kunakili ili ubandike. Omarchy huianzisha na preset ya ruhusa ya DeepSeek ya bila idhini. DeepSeek Harness hupakia kumbukumbu za kipindi kwa DeepSeek unapotumia API yake rasmi ya modeli; zima hilo chini ya Settings > General > Upload Session Log katika kiolesura chake cha kivinjari. Maoni unayoitumia pia hupakiwa pamoja na kipindi, isipokuwa ukiianzisha na DSH_TELEMETRY_MODE=DISABLED.

Wakala chaguo-msingi

Chagua wakala wako chaguo-msingi kwa omarchy default agent <name> au chini ya Setup > Defaults > Agent katika Menyu ya Omarchy (Super + Space). Ikiwa wakala bado hajasakinishwa, kumchagua humsakinisha kwanza. Omarchy mpya itakualika kufanya chaguo hili kwa arifa ya mara moja.

Kuchagua Claude pia hujaribu kusanidi kiendelezi chake cha kivinjari kwa Chromium, Chrome, Brave, Brave Origin, na Edge. Usanidi wa kiendelezi hutumika kwa watumiaji wote na unaweza kuomba nenosiri lako la mfumo; kughairi au usakinishaji wa kiendelezi ulioshindwa bado huchagua na kuzindua Claude. Anzisha kivinjari chako upya, wezesha kiendelezi ukiombwa, na uingie kwenye Claude ili kumaliza kukiunganisha. Endesha /chrome katika Claude ili kuangalia muunganiko. Firefox na Zen haziauni kiendelezi hiki. Ikiwa Claude tayari alikuwa chaguo-msingi lako kabla ya usanidi huu kuongezwa, mchague tena ili kusakinisha kiendelezi.

Baada ya kuchagua, Super + Shift + Ctrl + A huzindua wakala chaguo-msingi katika dirisha maalum la terminal (au huonyesha kichaguzi ikiwa bado hujachagua). Unaweza pia kumzindua moja kwa moja kwenye kazi kwa omarchy agent prompt "Review this project". Freebuff na DeepSeek Harness hazichukui kidokezo cha kuanzia, kwa hiyo hufunguka na kidokezo kwenye ubao wako wa kunakili ili ubandike badala yake. Mawakala waliozinduliwa hivi huendeshwa bila kusimamiwa katika hali zao husika za kutosimama-kuuliza, kwa hiyo uwe tayari kwao kufanya mambo kweli! MiniMax Code haina hali kama hiyo kwa vipindi vyake vya mwingiliano, kwa hiyo huomba ruhusa kama kawaida. Na kwa kuwa mawakala hukataa kukumbuka uaminifu kwa saraka yako ya nyumbani, uzinduzi kutoka $HOME huanza katika ~/Work badala yake.

Pia kuna mikato ya terminal: a huendesha wakala chaguo-msingi ndani ya terminal ya sasa, huku c, cx, na cy zikianzisha OpenCode, Claude Code, na Codex moja kwa moja (tena katika hali zao za kuidhinisha kiotomatiki). Mabadiliko ya mandhari pia husawazishwa kwa mawakala: Claude Code, Pi, OpenCode, na Hermes (mara Omarchy inapomsakinisha) wote hufuata unapobadilisha mandhari ya Omarchy.

Paneli ya mawakala

Upau wa juu una ikoni ya mawakala. Kabla hujasanidi wakala, paneli yake hukupitisha katika kuingia kwenye Claude, Codex, au Grok, na wa kwanza huwa wakala wako chaguo-msingi. Baada ya hapo, paneli huweka kila usajili kwenye ukurasa mmoja: kila wakala na akaunti na mpango wake, kipimo kwa kila kikomo chake cha kipindi cha saa 5 na cha wiki pamoja na muda hadi kinapowekwa upya (elea juu yake kwa asilimia kamili), au salio lililobaki la kulipia kabla, chini ya mstari unaozunguka kupitia ulichotumia katika yote, kama tokeni wiki hii na modeli unayoitumia zaidi. Chini ya Make something hutoa vidokezo vya kuanzia kwa mandhari, programu-jalizi, au programu mpya vinavyokabidhi kazi kwa wakala wako chaguo-msingi. Programu hujengwa kwa njia ileile za Omarchy zenyewe Hype, Monologue, na Omacut, katika C++ na Qt Quick, zikifuata ujuzi wa wakala wa omarchy-app, na mkusanyaji na vipande vya Qt wanavyohitaji huja vimesakinishwa. Claude Code, Codex, Grok, Kimi, Cursor na posho yake ya Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi, na Devin wamefunikwa mara moja na vikomo vyao, na Hermes, Mistral Vibe, na Qwen Code huonyesha vipindi na tokeni zao mara tu unapowatumia. Mipango na funguo za watoa huduma unazotumia kupitia pi, omp, au opencode pia huonekana: OpenCode Zen na Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan, na Synthetic na vikomo vyao; Fireworks, OpenRouter, na DeepSeek na salio zao za kulipia kabla; na modeli unazoendesha kwenye maunzi yako mwenyewe chini ya Local models. Kila wakala huhesabiwa mara moja, chini ya yeyote anayemtoza, bila kujali harness ngapi unamendeshea kupitia.

Bofya kushoto ikoni ya upau kwa paneli, bofya kulia kuzindua wakala wako chaguo-msingi. Kumbukumbu za matumizi nyuma yake hutengenezwa upya kila dakika 15 na omarchy agent usage-update, na paneli inaweza hata kuunganisha matumizi kutoka mashine zako nyingine kupitia folda iliyosawazishwa. Angalia README chini ya $OMARCHY_PATH/shell/plugins/agents/ kwa mipangilio kamili.

Usajili kadhaa

Ikiwa unalipia zaidi ya mpango mmoja wa Claude, Codex, au Grok - Max ya kibinafsi na ya kazini, kwa mfano - Omarchy inaweza kuwaweka wote wameingia na kuhama kati yao. Ongeza usajili kwa + katika paneli ya mawakala, inayokupitisha hapo hapo, au kwa omarchy agent account add claude Work (au codex, au grok). Husakinisha CLI ikiwa haipo. Akaunti ya kwanza kwa mtoa huduma huingia kupitia kivinjari chako cha kawaida, pale pale ambapo CLI hutafuta kila wakati. Kila moja baada ya hiyo huingia kupitia dirisha la faragha, kwa hiyo akaunti ambayo kivinjari chako tayari kimeingia haijachukuliwa kwa makosa; ingia hapo kama akaunti unayoongeza, na funga dirisha lolote la faragha ulilokuwa umelifungua kwanza. Kamwe usitoke kwenye CLI kufanya hivi: kutoka hubatilisha kuingia kulikohifadhiwa, na akaunti hiyo italazimika kuongezwa tena.

Ili kunakili maingizo yako ya usajili kwa mashine nyingine ya Omarchy kupitia SSH, endesha omarchy agent account copy user@laptop. Mtumaji hutoa kipokezi cha muda wakati mashine lengwa haina kilichosakinishwa, kwa hiyo mashine za zamani za Omarchy zinaweza kupokea akaunti bila sasisho. Vipokezi vilivyosakinishwa huchukua kipaumbele. Hii hunakili usajili wote wa Claude, Codex, na Grok; ongeza majina ya watoa huduma kuwachagua, kama katika omarchy agent account copy laptop claude. Majina ya akaunti na vitambulisho vya amri hulingana na chanzo, pamoja na akaunti tayari zilizopo kwenye lengwa. Akaunti za lengwa zisizohusiana hupokea kiambishi tamati cha nambari ikiwa majina yao yanakinzana, na mipangilio, ujuzi, programu-jalizi, na historia ya mazungumzo hubaki ndani ya kila mashine.

Vitambulisho vilivyopo vya lengwa huhifadhiwa. Akaunti ya chanzo tayari iliyoingia hapo hupata jina lake kusawazishwa bila kubadilisha vitambulisho vyake; akaunti nyingine huongezwa kando yake. Ili kubadilisha vitambulisho vilivyohifadhiwa kwa akaunti zinazolingana, tumia omarchy agent account copy --replace laptop claude baada ya kuacha vipindi vya akaunti hiyo kwenye lengwa. Lengwa jipya pia hupata akaunti hai ya chanzo na mapendeleo ya kubadilisha; lengwa lililoimarika huhifadhi yake.

Vitambulisho husafiri kupitia SSH na huhifadhiwa katika faili za faragha kwenye lengwa, kwa hiyo nakili tu kwa mashine unazoziamini. Hii ni nakala ya mara moja, si usawazishaji unaoendelea. Tokeni za kuonyesha upya za Codex zinaweza kuzungushwa na mashine nyingine, na kuacha nakala ya kuingia ikihitaji kufanywa upya; maingizo tofauti hubaki chaguo la kuaminika zaidi kwa matumizi ya wakati mmoja kwenye mashine kadhaa. Angalia mwongozo wa uthibitishaji wa akaunti wa Codex.

Akaunti moja kwa kila mtoa huduma ndiyo hai, na kila kipindi kipya huanza kama hiyo: cx, cy, claude, codex, au grok ya kawaida, chochote kilichozinduliwa kupitia omarchy agent, na hati au vihariri vinavyopata CLI kwenye PATH. Badilisha kwa omarchy agent account use work (na kurudi kwa omarchy agent account use main), au katika paneli kwa kubonyeza nambari ya akaunti kisha Enter (au kubofya kitufe chake cha Use). Vipindi ambavyo tayari vinaendeshwa hubaki kwenye akaunti waliyoanzia. Historia ya mazungumzo, mipangilio, ujuzi, na programu-jalizi hushirikiwa katika akaunti zote, kwa hiyo claude --continue katika folda ileile huendelea pale ulipoachia kwenye akaunti mpya.

Ukiwa na zaidi ya akaunti moja, paneli huonyesha vikomo vya kila akaunti kando kwa kando, na ile hai ikiwa imetiwa alama. Kwa chaguo-msingi Omarchy hukujulisha wakati akaunti hai inapopita 95% ya kikomo, na kubofya arifa hubadilisha hadi akaunti yenye nafasi kubwa zaidi. Elea juu ya mstari wa akaunti katika paneli na ubofye Autoswitch inayoonekana kando ya Use (au bonyeza m), au endesha omarchy agent account mode auto, ili ibadilishe yenyewe badala yake; ikiwa imewashwa, Autoswitch huchukua nafasi ya Use, na kuibofya tena hurudi kwenye kukujulisha. Ongeza nambari kubadilisha kizingiti, kama katika omarchy agent account mode auto 90. Ikiwa kila akaunti iko juu ya kizingiti, utasikia kuhusu hilo mara moja, pamoja na akaunti inayofunguka kwanza. Wakati akaunti hai iko ndani ya pointi 15 za kizingiti chake (80% kwa chaguo-msingi), vikomo vyake hukaguliwa kila dakika tatu badala ya kila 15.

omarchy agent account list huonyesha kila akaunti na vikomo vyake vya hivi karibuni, omarchy agent account remove work husahau moja, na omarchy agent account rename primary Hey hubadilisha jina la moja (au bofya jina la akaunti katika paneli). Amri hizi hufanya kazi kwenye akaunti za wakala wako chaguo-msingi; kufikia mtoa huduma mwingine, mtaje kwanza, kama katika omarchy agent account use codex side. Kuingia uliyokuwa nayo tayari katika ~/.claude au ~/.codex ni akaunti ya Main na hubaki pale ilipo. Akaunti iliyoachwa bila kutumika kwa zaidi ya takriban saa nane inaweza kuonyesha Sign-in required; ibofye ili kuingia akaunti hiyo tena pale pale katika paneli, au anza kipindi ndani yake, ambacho huonyesha upya kuingia yenyewe. Seva za MCP ulizokuwa nazo wakati akaunti ilipoongezwa huja nayo, lakini zile unazoongeza baadaye kwa claude mcp add hufikia tu akaunti uliyoziingiza. Claude Desktop na zana zilizosanidiwa na njia kamili hadi programu ya CLI hazifuati ubadilishaji. CLAUDE_CONFIG_DIR, CODEX_HOME, au GROK_HOME iliyo wazi huchukua kipaumbele kuliko akaunti iliyochaguliwa.

Utambuzi wa kuanguka

Omarchy hutazama systemd-coredump kwa kuanguka kwa michakato. Kitu kinapopata segfault, utapata arifa ya “Process crashed” - ibofye, na kuanguka hukabidhiwa kwa wakala wako chaguo-msingi pamoja na ujuzi wa Omarchy wa diagnose-crash, unaomupitisha wakala katika kuthibitisha ukweli kutoka kwenye core dump na kuamua ikiwa kuanguka kunastahili kuripotiwa upstream. Unaweza pia kuiendesha kwa mkono dhidi ya PID yoyote kutoka coredumpctl list kwa omarchy agent crash <pid>.

Utazamaji umewashwa kwa chaguo-msingi. Zima chini ya Trigger > Toggle > Crash Capture (au kwa omarchy toggle crash-capture) na arifa husimama; omarchy agent crash <pid> bado hufanya kazi kwa mkono.

Kuanguka kunaweza pia kunyamazishwa programu moja kwa wakati, jambo ambalo utambuzi hukupa mwishoni. omarchy crash mute hyprland husimamisha arifa kwa programu hiyo pekee, omarchy crash mute hyprland off huzirudisha, na omarchy crash mute yenyewe huorodhesha ulichonyamazisha. Huchukua njia ya programu kama inavyochukua jina lake, kwa hiyo omarchy crash mute /usr/bin/hyprland hufanya jambo lileile. Nukuu jina lenye nafasi ndani yake, kama katika omarchy crash mute 'Some App'. Kila kitu kingine bado hujulisha, na programu iliyonyamazishwa bado huanguka - hii huficha ukumbusho, hairekebishi chochote.

Programu za eneo-kazi

Menyu ya Install > AI pia hubeba programu chache za AI za picha: programu ya eneo-kazi ya ChatGPT, programu ya eneo-kazi ya Claude (beta ya Linux ya Anthropic, na vichupo vya Chat, Cowork, na Claude Code), Grok Bot ya kuzungumza na modeli za xAI, Hermes Desktop, OpenClaw, programu ya eneo-kazi ya Perplexity, na T3 Code. Grok Bot ni programu ya gumzo ya eneo-kazi. Wakala wa kuandika msimbo ni amri ya grok.

Hermes Desktop ndiyo ya kujua, kwa sababu mashine ina Hermes mmoja, na ni ya programu: Hermes husakinishwa tu kupitia programu, na amri ya hermes ambayo wakala chaguo-msingi huendesha ni ya programu. Kuchagua Hermes kama wakala chaguo-msingi husakinisha jambo lileile ambalo ingizo la Install > AI hufanya: kifurushi, na runtime ya Hermes chini ya ~/.hermes iliyosanidiwa na kisakinishaji cha Hermes chenyewe, ambacho huchukua dakika chache mara ya kwanza. Runtime hiyo ndiyo Hermes mmoja ambayo amri ya terminal ya hermes, wakala chaguo-msingi na programu zote hutumia, na hujisasisha yenyewe kwa hermes update badala ya kusubiri toleo la Omarchy. Kuisanidi pia humkabidhi Hermes mandhari ya Omarchy kama ngozi iitwayo omarchy, ambayo kila uso wa Hermes hufuata unapobadilisha mandhari; chagua nyingine chini ya mipangilio ya Appearance ya Hermes au kwa /skin ikiwa ungependa isifanye hivyo, na Omarchy huacha chaguo hilo peke yake. Kuondoa programu chini ya Remove > AI hufunga Hermes kwanza, gateway ikiwemo, huchukua runtime hiyo nayo, na huhifadhi gumzo zako, kumbukumbu, na ujuzi ambao Hermes alijiandikia isipokuwa ukiambia vinginevyo: huuliza, kwa chaguo-msingi la hapana, ikiwa data hiyo na mipangilio yako ya muunganiko inapaswa kwenda pia.

Matumizi ya eneo-kazi ya OpenClaw ni Control UI yake, ambayo hufunguka kama programu ya wavuti inayoungwa mkono na gateway yake ya ndani. OpenClaw huishi katika ~/.openclaw na hujisasisha yenyewe: tumia kitufe cha “Update Gateway” cha Control UI au endesha openclaw update, na gateway huaji upya kwenye toleo jipya. Omarchy huchagua tu toleo ambalo usakinishaji mpya huanza nalo. Kuondoa OpenClaw chini ya Remove > AI huchukua huduma ya gateway na programu nayo na kisha huuliza ikiwa ~/.openclaw inapaswa kwenda pia, kwa kuwa hiyo huhifadhi gumzo zako na vitambulisho pamoja na OpenClaw yenyewe na runtime za programu-jalizi inayopakua; chaguo-msingi huihifadhi, na kusakinisha OpenClaw tena huiichukua tena.

T3 Code huendeshwa kutoka toleo lake rasmi la AppImage katika ~/.local/share/t3code badala ya kutoka kwenye kifurushi, kwa hiyo hujisasisha yenyewe. Kuisanidi huuliza ikiwa uanze kwenye chaneli ya Stable au Nightly; badilisha baadaye katika mipangilio ya T3 Code. Nyuzi zako na mipangilio huishi katika ~/.t3, na kuondoa T3 Code chini ya Remove > AI huchukua navyo.

LLM za ndani

Omarchy inapendekeza njia mbili za kuendesha modeli za LLM za ndani: LM Studio na Ollama. LM Studio hutoa kiolesura cha GUI cha kutafuta modeli za uzani wazi, kuzisakinisha, na kuziendesha. Ni njia nzuri ya kuanza kwa urahisi. Ollama hutoa CLI ya kufanya hivyo vivyo hivyo. Lakini ikiwa wewe ni mgeni kwa modeli za ndani, ningeanza na LM Studio. Unaweza kusakinisha yoyote chini ya Install > AI katika Menyu ya Omarchy.

Ujuzi wa Omarchy

Ujuzi wa mawakala husaidia AI kutumia zana maalum kwa njia maalum, na Omarchy huja na ujuzi chaguo-msingi wa kurekebisha mfumo. Kama kurekebisha usanidi wako wa Hyprland, kurekebisha upau, au hata kuunda mandhari mapya kutoka mwanzo. Umeunganishwa kwa ulinganifu katika saraka za ujuzi za Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills na kila ~/.hermes/profiles/*/skills), na eneo la jumla la ~/.agents/skills, kwa hiyo harness nyingi huuchukua kiotomatiki.

Lakini unapaswa kuchukulia ujuzi huu kama wa majaribio. Modeli tofauti huutumia kwa athari tofauti. Ni bora kuendesha katika hali ya mpango kwanza, ili uwe na wazo la kile wakala angependa kubadilisha. Na kisha uwe tayari kurudisha nyuma mabadiliko au hata kuita omarchy reinstall configs, ikiwa wakala ataharibu kila kitu.