Langkau ke kandungan
Chapters
  1. Selamat Datang ke Omarchy!
  2. Bermula
  3. Datang dari Mac atau Windows
  4. Navigasi
  5. Bar Atas
  6. Tema
  7. Kekunci Pintas
  8. Papan Keratan Bersepadu & Sejarah
  9. Peringatan
  10. Notis
  11. Pengekstrakan Teks & Pendiktean
  12. Tangkapan Skrin & Rakaman
  13. Togol, Melahu & Penyelamat Skrin
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Alat Pembangunan
  19. Alatan Shell
  20. Fungsi Shell
  21. TUIs
  22. GUI
  23. Pelayar
  24. Aplikasi/perkhidmatan komersial
  25. Aplikasi Web
  26. Permainan
  27. Mengisi PDF
  28. VM Windows
  29. Pakej Lain
  30. Kemas Kini
  31. Dotfiles
  32. Plugin Shell
  33. Monitor
  34. Papan Kekunci, Tetikus, Pad Jejak
  35. Rangkaian
  36. Tidur sistem
  37. Pengesahan perkakasan
  38. Fon
  39. Latar Belakang
  40. Gesaan
  41. Penjenamaan
  42. Pelarasan biasa
  43. Membuat tema anda sendiri
  44. Sokongan Mac
  45. Penyelesaian masalah
  46. Soalan Lazim
  47. Snapshot sistem
  48. Keselamatan
  49. Omarchy pada...
  50. Pemasangan Dual Boot
  51. Pemasangan Tanpa Pengawasan

Manual

AI

Omarchy menyertakan pelancar untuk ejen pengekodan di bawah tanpa memilih lalai untuk anda. Jalankan satu arahan untuk memasang CLI-nya pada penggunaan pertama, kemudian sahkan identiti apabila diminta. Hermes ialah pengecualian: tiada apa-apa dipasang untuknya pada penggunaan pertama, dan memilihnya akan memasang Hermes Desktop, seperti yang diterangkan oleh Aplikasi desktop di bawah.

Arahan Ejen
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 daripada Cognition
dsh DeepSeek Harness
freebuff Freebuff, ejen pengekodan percuma dan disokong iklan daripada Codebuff
grok Grok Build daripada xAI
hermes Hermes, ejen daripada Nous Research
kilo Kilo, ejen pengekodan berasaskan OpenCode
kimi Kimi Code
kiro-cli Kiro CLI
mcode MiniMax Code, ejen pengekodan daripada MiniMax
muse Muse Code, ejen pengekodan daripada Meta
omp Oh My Pi
ori Ori, harness daripada OpenRouter
pi Pi oleh Mario Zechner
qwen Qwen Code, ejen pengekodan daripada Alibaba

ori ialah yang ganjil: ia menjalankan harness lain terhadap keseluruhan katalog model OpenRouter, jadi ori claude, ori codex, atau ori opencode memulakan ejen tersebut pada mana-mana model yang anda halakan kepadanya, dan ori code ialah ejen Ori sendiri.

Memasang dan mengemas kini ejen

Kecuali Hermes, ejen-ejen ini menggunakan pemasangan malas mise: pelancaran pertama memasang CLI, dan pelancaran seterusnya menggunakannya semula. mise juga menyemak ejen yang dipasang untuk keluaran baharu paling kerap sekali setiap empat jam, sejurus sebelum ia bermula atau di latar belakang pada prompt shell. Jika kemas kini itu gagal atau anda berada di luar talian, versi yang dipasang akan dijalankan. omarchy update mengemas kini ejen yang dipasang bersama-sama seluruh Omarchy, dan mup mengemas kini alatan yang diuruskan oleh mise sahaja.

Pengemas kini ejen itu sendiri, seperti claude update, codex update, atau butang kemas kini dalam aplikasi, tidak mengemas kini pemasangan yang diuruskan oleh mise. codex update gagal, dan claude update boleh melaporkan kejayaan sambil memasang salinan berasingan yang tidak dijejak oleh mise. Jika anda lebih suka menggunakan pemasang dan pengemas kini natif ejen, tambahkannya pada disable_tools; lihat Alatan CLI yang diprapasang.

Untuk memasang semua alatan malas yang dikonfigurasikan sebelum anda memerlukannya, jalankan mise install --include-lazy. Ini termasuk alatan CLI lalai Omarchy yang lain serta ejen-ejen tersebut. Lihat Alatan CLI yang diprapasang untuk memasang satu alatan atau menggunakan pemasangan anda sendiri.

grok dipasang melalui pakej pihak pertama grok mise, dengan cara yang sama seperti claude dan codex. Jalankan grok, atau pilihnya di bawah Setup > Defaults > Agent. Langkau pemasang curl | bash di x.ai. Laluan itu meletakkan salinan kedua dalam ~/.grok/bin, mendahulukannya pada PATH, dan menimpa wrapper Omarchy.

dsh membuka UI pelayarnya pada 127.0.0.1:3080, dengan direktori pelancaran sebagai ruang kerja laluinya. UI pelayarnya tidak menerima prompt permulaan, jadi omarchy agent prompt membukanya dengan prompt pada papan keratan anda untuk ditampal. Omarchy memulakannya dengan pratetap kebenaran tanpa kelulusan daripada DeepSeek. DeepSeek Harness memuat naik log sesi ke DeepSeek apabila anda menggunakan API model rasminya; matikan itu di bawah Settings > General > Upload Session Log dalam UI pelayarnya. Maklum balas yang anda hantar kepadanya turut dimuat naik bersama sesi, melainkan anda memulakannya dengan DSH_TELEMETRY_MODE=DISABLED.

Ejen lalai

Pilih ejen lalai anda dengan omarchy default agent <name> atau di bawah Setup > Defaults > Agent dalam Menu Omarchy (Super + Space). Jika ejen itu belum dipasang, memilihnya akan memasangnya terlebih dahulu. Omarchy yang baharu akan menjemput anda membuat pilihan ini dengan pemberitahuan sekali sahaja.

Memilih Claude juga cuba menyediakan sambungan pelayarnya untuk Chromium, Chrome, Brave, Brave Origin, dan Edge. Penyediaan sambungan digunakan untuk semua pengguna dan mungkin meminta kata laluan sistem anda; membatalkan atau pemasangan sambungan yang gagal tetap memilih dan melancarkan Claude. Mulakan semula pelayar anda, dayakan sambungan jika diminta, dan log masuk ke Claude untuk selesai menyambungkannya. Jalankan /chrome dalam Claude untuk menyemak sambungan. Firefox dan Zen tidak menyokong sambungan ini. Jika Claude sudah menjadi lalai anda sebelum penyediaan ini ditambah, pilihnya semula untuk memasang sambungan.

Sebaik sahaja anda telah memilih, Super + Shift + Ctrl + A melancarkan ejen lalai dalam tetingkap terminal khusus (atau memaparkan pemilih jika anda belum memilih). Anda juga boleh melancarkannya terus ke dalam tugasan dengan omarchy agent prompt "Review this project". Freebuff dan DeepSeek Harness tidak menerima prompt permulaan, jadi ia dibuka dengan prompt pada papan keratan anda untuk ditampal sebagai ganti. Ejen yang dilancarkan dengan cara ini berjalan tanpa pengawasan dalam mod jangan-berhenti-untuk-bertanya masing-masing, jadi bersedialah kerana ia benar-benar akan melakukan sesuatu! MiniMax Code tidak mempunyai mod sedemikian untuk sesi interaktifnya, jadi ia meminta kebenaran seperti biasa. Dan memandangkan ejen enggan mengingati kepercayaan untuk direktori utama anda, pelancaran dari $HOME bermula di ~/Work sebagai ganti.

Terdapat juga pintasan terminal: a menjalankan ejen lalai secara sebaris dalam terminal semasa, manakala c, cx, dan cy memulakan OpenCode, Claude Code, dan Codex secara langsung (sekali lagi dalam mod meluluskan secara automatik mereka). Perubahan tema turut disegerakkan kepada ejen: Claude Code, Pi, OpenCode, dan Hermes (setelah Omarchy memasangnya) semuanya mengikut apabila anda menukar tema Omarchy.

Panel ejen

Bar atas mempunyai ikon ejen. Sebelum anda menyediakan ejen, panelnya membimbing anda melalui log masuk ke Claude, Codex, atau Grok, dan yang pertama menjadi ejen lalai anda. Selepas itu, panel meletakkan setiap langganan pada satu halaman: setiap ejen dan akaun dengan pelannya, meter untuk setiap had sesi 5 jam dan had mingguannya beserta masa sehingga ia ditetapkan semula (letakkan kursor di atasnya untuk peratusan tepat), atau baki prabayar yang tinggal, di bawah baris yang berputar melalui apa yang telah anda gunakan merentas kesemuanya, seperti token minggu ini dan model anda yang paling banyak digunakan. Di bawah Make something ia menawarkan prompt permulaan untuk tema, plugin, atau aplikasi baharu yang menyerahkan tugasan kepada ejen lalai anda. Aplikasi dibina dengan cara aplikasi Omarchy sendiri iaitu Hype, Monologue, dan Omacut dibina, dalam C++ dan Qt Quick, mengikut kemahiran ejen omarchy-app, dan pengkompil serta komponen Qt yang diperlukannya datang terpasang. Claude Code, Codex, Grok, Kimi, Cursor dan elaun Grok Bot-nya, GitHub Copilot, Muse, Antigravity, Kimchi, dan Devin diliputi secara sedia ada dengan had mereka, dan Hermes, Mistral Vibe, dan Qwen Code menunjukkan sesi dan token mereka setelah anda menggunakannya. Pelan dan kunci pembekal yang anda gunakan melalui pi, omp, atau opencode turut muncul: OpenCode Zen dan Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan, dan Synthetic dengan had mereka; Fireworks, OpenRouter, dan DeepSeek dengan baki prabayar mereka; dan model yang anda jalankan pada perkakasan anda sendiri di bawah Local models. Setiap ejen dikira sekali, di bawah pihak yang mengebilnya, tidak kira berapa banyak harness anda menggunakannya melaluinya.

Klik kiri ikon bar untuk panel, klik kanan untuk melancarkan ejen lalai anda. Rekod penggunaan di belakangnya dijana semula setiap 15 minit oleh omarchy agent usage-update, dan panel malah boleh menggabungkan penggunaan daripada mesin anda yang lain melalui folder yang disegerakkan. Lihat README di bawah $OMARCHY_PATH/shell/plugins/agents/ untuk tetapan penuh.

Beberapa langganan

Jika anda membayar untuk lebih daripada satu pelan Claude, Codex, atau Grok - contohnya Max peribadi dan satu lagi untuk kerja - Omarchy boleh memastikan kesemuanya kekal dilog masuk dan bergerak antara mereka. Tambah langganan dengan + dalam panel ejen, yang membimbing anda melaluinya di situ juga, atau dengan omarchy agent account add claude Work (atau codex, atau grok). Ia memasang CLI jika ia tiada. Akaun pertama untuk pembekal log masuk melalui pelayar biasa anda, tepat di tempat CLI sentiasa mencarinya. Setiap akaun selepas itu log masuk melalui tetingkap peribadi, supaya akaun yang pelayar anda sudah log masuk kepadanya tidak terambil secara tidak sengaja; log masuk di situ sebagai akaun yang anda tambah, dan tutup mana-mana tetingkap peribadi yang sudah anda buka terlebih dahulu. Jangan sekali-kali log keluar daripada CLI untuk melakukan ini: log keluar membatalkan log masuk yang disimpan, dan akaun itu perlu ditambah semula.

Untuk menyalin log masuk langganan anda ke mesin Omarchy lain melalui SSH, jalankan omarchy agent account copy user@laptop. Pengirim membekalkan penerima sementara apabila destinasi tidak mempunyai satu yang dipasang, jadi mesin Omarchy yang lebih lama boleh menerima akaun tanpa kemas kini. Penerima yang dipasang diutamakan. Ini menyalin semua langganan Claude, Codex, dan Grok; tambah nama pembekal untuk memilihnya, seperti dalam omarchy agent account copy laptop claude. Nama akaun dan ID arahan sepadan dengan sumber, termasuk akaun yang sudah ada pada destinasi. Akaun destinasi yang tidak berkaitan menerima akhiran angka jika namanya bercanggah, dan tetapan, kemahiran, plugin, serta sejarah perbualan kekal setempat pada setiap mesin.

Kelayakan destinasi sedia ada dikekalkan. Akaun sumber yang sudah dilog masuk di situ namanya disegerakkan tanpa menggantikan kelayakannya; akaun lain ditambah di sampingnya. Untuk menggantikan kelayakan yang disimpan bagi akaun yang sepadan, gunakan omarchy agent account copy --replace laptop claude selepas menutup sesi akaun itu pada destinasi. Destinasi baharu turut menerima akaun aktif dan keutamaan penukaran sumber; destinasi yang sudah mantap mengekalkan miliknya sendiri.

Kelayakan bergerak melalui SSH dan disimpan dalam fail peribadi pada destinasi, jadi salin hanya ke mesin yang anda percayai. Ini ialah salinan sekali sahaja, bukan penyegerakan berterusan. Token segar semula Codex boleh diputar oleh mesin lain, menyebabkan log masuk yang disalin memerlukan pembaharuan; log masuk berasingan kekal pilihan paling boleh dipercayai untuk penggunaan serentak pada beberapa mesin. Lihat panduan pengesahan akaun Codex.

Satu akaun bagi setiap pembekal adalah aktif, dan setiap sesi baharu bermula sebagai akaun itu: cx, cy, claude, codex, atau grok biasa, apa-apa sahaja yang dilancarkan melalui omarchy agent, dan skrip atau editor yang menemui CLI pada PATH. Tukar dengan omarchy agent account use work (dan kembali dengan omarchy agent account use main), atau dalam panel dengan menekan nombor akaun dan kemudian Enter (atau mengklik butang Use-nya). Sesi yang sudah berjalan kekal pada akaun yang ia mulakan. Sejarah perbualan, tetapan, kemahiran, dan plugin dikongsi merentas akaun, jadi claude --continue dalam folder yang sama menyambung dari tempat anda berhenti pada akaun baharu.

Dengan lebih daripada satu akaun, panel menunjukkan had setiap akaun bersebelahan, dengan akaun aktif ditandakan. Secara lalai Omarchy memberitahu anda apabila akaun aktif melepasi 95% daripada had, dan mengklik pemberitahuan menukar kepada akaun dengan ruang paling banyak. Letakkan kursor di atas baris akaun dalam panel dan klik Autoswitch yang muncul di sebelah Use (atau tekan m), atau jalankan omarchy agent account mode auto, untuk membolehkannya bertukar sendiri sebagai ganti; semasa ia aktif, Autoswitch mengambil tempat Use, dan mengkliknya semula kembali kepada pemberitahuan. Tambah nombor untuk menukar ambang, seperti dalam omarchy agent account mode auto 90. Jika setiap akaun melepasi ambang, anda akan dimaklumkan sekali, bersama akaun mana yang bebas terlebih dahulu. Semasa akaun aktif berada dalam 15 mata daripada ambangnya (80% pada lalai), hadnya disemak setiap tiga minit dan bukannya setiap 15.

omarchy agent account list menunjukkan setiap akaun dan had terkininya, omarchy agent account remove work melupakan satu akaun, dan omarchy agent account rename primary Hey menamakan semula satu akaun (atau klik nama akaun dalam panel). Arahan ini berfungsi pada akaun ejen lalai anda; untuk mencapai pembekal lain, namakannya terlebih dahulu, seperti dalam omarchy agent account use codex side. Log masuk yang sudah anda miliki dalam ~/.claude atau ~/.codex ialah akaun Main dan kekal di tempatnya. Akaun yang dibiarkan tidak digunakan selama lebih daripada kira-kira lapan jam boleh menunjukkan Sign-in required; kliknya untuk melog masuk akaun itu semula terus dalam panel, atau mulakan sesi di dalamnya, yang menyegarkan semula log masuk dengan sendirinya. Pelayan MCP yang anda miliki semasa akaun ditambah ikut serta ke dalamnya, tetapi yang anda tambah kemudian dengan claude mcp add hanya sampai ke akaun tempat anda menambahnya. Claude Desktop dan alatan yang dikonfigurasikan dengan laluan mutlak ke binari CLI tidak mengikut penukaran. CLAUDE_CONFIG_DIR, CODEX_HOME, atau GROK_HOME yang eksplisit diutamakan berbanding akaun yang dipilih.

Diagnosis ranap

Omarchy memerhati systemd-coredump untuk ranap proses. Apabila sesuatu mengalami segfault, anda akan mendapat pemberitahuan “Process crashed” - kliknya, dan ranap itu diserahkan kepada ejen lalai anda bersama kemahiran diagnose-crash Omarchy, yang membimbing ejen melalui penetapan fakta daripada core dump dan penentuan sama ada ranap itu berbaloi dilaporkan ke peringkat atas. Anda juga boleh menjalankannya secara manual terhadap mana-mana PID daripada coredumpctl list dengan omarchy agent crash <pid>.

Pemerhatian ini aktif secara lalai. Matikannya di bawah Trigger > Toggle > Crash Capture (atau dengan omarchy toggle crash-capture) dan pemberitahuan berhenti; omarchy agent crash <pid> masih berfungsi secara manual.

Ranap juga boleh disenyapkan satu program pada satu masa, yang merupakan perkara yang diagnosis tawarkan kepada anda pada penghujungnya. omarchy crash mute hyprland menghentikan pemberitahuan untuk program itu sahaja, omarchy crash mute hyprland off mengembalikannya, dan omarchy crash mute dengan sendirinya menyenaraikan apa yang telah anda senyapkan. Ia menerima laluan binari sama gembiranya seperti namanya, jadi omarchy crash mute /usr/bin/hyprland melakukan perkara yang sama. Petik nama yang mempunyai ruang di dalamnya, seperti dalam omarchy crash mute 'Some App'. Semua yang lain masih memberitahu, dan program yang disenyapkan masih ranap - ini menyembunyikan peringatan, ia tidak membaiki apa-apa.

Aplikasi desktop

Menu Install > AI turut membawa beberapa aplikasi AI grafik: aplikasi desktop ChatGPT, aplikasi desktop Claude (beta Linux Anthropic, dengan tab Chat, Cowork, dan Claude Code), Grok Bot untuk berbual dengan model xAI, Hermes Desktop, OpenClaw, aplikasi desktop Perplexity, dan T3 Code. Grok Bot ialah aplikasi sembang desktop. Ejen pengekodan ialah arahan grok.

Hermes Desktop ialah yang perlu diketahui, kerana sesebuah mesin mempunyai satu Hermes, dan ia milik aplikasi itu: Hermes hanya pernah dipasang melalui aplikasi, dan arahan hermes yang dijalankan oleh ejen lalai ialah milik aplikasi itu. Memilih Hermes sebagai ejen lalai memasang perkara yang sama seperti entri Install > AI: pakej, dan runtime Hermes di bawah ~/.hermes yang disediakan oleh pemasang Hermes sendiri, yang mengambil masa beberapa minit pada kali pertama. Runtime itu ialah satu-satunya Hermes yang digunakan oleh arahan terminal hermes, ejen lalai dan aplikasi, dan ia mengemas kini dirinya sendiri dengan hermes update dan bukannya menunggu keluaran Omarchy. Memasangnya turut menyerahkan tema Omarchy kepada Hermes sebagai skin bernama omarchy, yang diikuti oleh setiap permukaan Hermes semasa anda menukar tema; pilih yang lain di bawah tetapan Appearance Hermes atau dengan /skin jika anda lebih suka ia tidak berbuat demikian, dan Omarchy membiarkan pilihan itu sahaja. Mengalih keluar aplikasi di bawah Remove > AI menutup Hermes terlebih dahulu, termasuk gateway, mengambil runtime itu bersamanya, dan mengekalkan sembang, memori, dan kemahiran yang Hermes tulis untuk dirinya melainkan anda menyuruhnya sebaliknya: ia bertanya, dengan lalai tidak, sama ada data itu dan tetapan sambungan anda patut dialih keluar juga.

Pengalaman desktop OpenClaw ialah Control UI-nya, yang dibuka sebagai aplikasi web yang disokong oleh gateway tempatannya sendiri. OpenClaw berada dalam ~/.openclaw dan mengemas kini dirinya sendiri: gunakan butang “Update Gateway” Control UI atau jalankan openclaw update, dan gateway dimulakan semula pada versi baharu. Omarchy hanya memilih keluaran yang pemasangan baharu bermula daripadanya. Mengalih keluar OpenClaw di bawah Remove > AI mengambil perkhidmatan gateway dan aplikasi bersamanya dan kemudian bertanya sama ada ~/.openclaw patut dialih keluar juga, kerana itu menyimpan sembang dan kelayakan anda bersama OpenClaw itu sendiri dan runtime plugin yang dimuat turunnya; lalai mengekalkannya, dan memasang OpenClaw semula mengambilnya kembali.

T3 Code berjalan daripada keluaran AppImage rasminya dalam ~/.local/share/t3code dan bukannya daripada pakej, jadi ia mengemas kini dirinya sendiri. Memasangnya bertanya sama ada untuk bermula pada saluran Stable atau Nightly; tukar kemudian dalam tetapan T3 Code. Thread dan tetapan anda berada dalam ~/.t3, dan mengalih keluar T3 Code di bawah Remove > AI mengambilnya bersama.

LLM tempatan

Omarchy mengesyorkan dua cara menjalankan model LLM tempatan: LM Studio dan Ollama. LM Studio menyediakan antara muka GUI untuk mencari model open-weight, memasangnya, dan menjalankannya. Ia cara yang hebat untuk bermula dengan mudah. Ollama menawarkan CLI untuk melakukan perkara yang sama. Tetapi jika anda baharu dalam model tempatan, saya akan bermula dengan LM Studio. Anda boleh memasang mana-mana satu di bawah Install > AI dalam Menu Omarchy.

Kemahiran Omarchy

Kemahiran ejen membantu AI menggunakan alatan tertentu dengan cara tertentu, dan Omarchy disertakan dengan kemahiran lalai untuk menyesuaikan sistem. Seperti mengubah suai konfigurasi Hyprland anda, melaraskan bar, atau malah mencipta tema baharu dari kosong. Ia disimlink ke dalam direktori kemahiran untuk Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills dan setiap ~/.hermes/profiles/*/skills), dan lokasi generik ~/.agents/skills, jadi kebanyakan harness mengambilnya secara automatik.

Tetapi anda patut menganggap kemahiran ini sebagai eksperimen. Model yang berbeza akan menggunakannya dengan kesan yang berbeza. Sebaiknya jalankannya dalam mod pelan terlebih dahulu, supaya anda mempunyai idea tentang apa yang ejen ingin ubah. Dan kemudian bersedia untuk membuat rollback perubahan atau malah menggunakan omarchy reinstall configs, jika ejen mengacaukan semuanya.