Прескочи към съдържанието
Chapters
  1. Добре дошли в Omarchy!
  2. Първи стъпки
  3. Идваш от Mac или Windows
  4. Навигация
  5. Горната лента
  6. Теми
  7. Бързи клавиши
  8. Единен клипборд и история
  9. Напомняния
  10. Известия
  11. Извличане на текст и диктовка
  12. Екранни снимки и запис
  13. Превключватели, бездействие и скрийнсейвърът
  14. Omarchy CLI
  15. Терминал
  16. Neovim
  17. AI
  18. Инструменти за разработка
  19. Инструменти за шел
  20. Функции на шела
  21. TUIs
  22. Графични приложения
  23. Браузъри
  24. Търговски приложения/услуги
  25. Уеб приложения
  26. Игри
  27. Попълване на PDF файлове
  28. Windows VM
  29. Други пакети
  30. Актуализации
  31. Dotfiles
  32. Плъгини за шела
  33. Монитори
  34. Клавиатура, мишка, тракпад
  35. Мрежа
  36. Заспиване на системата
  37. Хардуерно удостоверяване
  38. Шрифтове
  39. Фонове
  40. Подкана
  41. Брандиране
  42. Чести настройки
  43. Създаване на собствена тема
  44. Поддръжка на Mac
  45. Отстраняване на проблеми
  46. Често задавани въпроси
  47. Системни моментни снимки
  48. Сигурност
  49. Omarchy на...
  50. Инсталация с двойно зареждане
  51. Инсталации без надзор

Ръководство

AI

Omarchy включва стартери за кодиращите агенти по-долу, без да избира такъв по подразбиране вместо вас. Изпълнете команда, за да инсталирате нейния CLI при първо използване, след което се удостоверeте, когато бъдете подканени. Hermes е изключението: за него при първо използване не се инсталира нищо, а избирането му инсталира Hermes Desktop, както е обяснено в Настолни приложения по-долу.

Команда Агент
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 от Cognition
dsh DeepSeek Harness
freebuff Freebuff, безплатният, поддържан от реклами кодиращ агент на Codebuff
grok Grok Build от xAI
hermes Hermes, агентът на Nous Research
kilo Kilo, кодиращ агент, базиран на OpenCode
kimi Kimi Code
kiro-cli Kiro CLI
mcode MiniMax Code, кодиращият агент на MiniMax
muse Muse Code, кодиращият агент на Meta
omp Oh My Pi
ori Ori, обвивката на OpenRouter
pi Pi на Mario Zechner
qwen Qwen Code, кодиращият агент на Alibaba

ori е странната птица: той изпълнява другите обвивки срещу целия каталог от модели на OpenRouter, така че ori claude, ori codex или ori opencode стартират тези агенти на който модел им посочите, а ori code е собственият агент на Ori.

Инсталиране и актуализиране на агенти

С изключение на Hermes, тези агенти използват ленивата инсталация на mise: първото стартиране инсталира CLI, а следващите стартирания го използват повторно. mise също проверява инсталиран агент за нова версия най-много веднъж на всеки четири часа, точно преди да стартира или във фонов режим в подкана на обвивката. Ако тази актуализация се провали или сте офлайн, работи инсталираната версия. omarchy update актуализира инсталираните агенти заедно с останалата част от Omarchy, а mup актуализира само инструментите, управлявани от mise.

Собственият актуализатор на даден агент, като claude update, codex update или бутон за актуализиране в приложение, не актуализира инсталацията, управлявана от mise. codex update се проваля, а claude update може да съобщи за успех, докато инсталира отделно копие, което mise не проследява. Ако предпочитате да използвате собствения инсталатор и актуализатор на даден агент, добавете го в disable_tools; вижте Предварително инсталирани CLI инструменти.

За да инсталирате всички конфигурирани лениви инструменти, преди да ви потрябват, изпълнете mise install --include-lazy. Това включва другите CLI инструменти по подразбиране на Omarchy, както и агентите. Вижте Предварително инсталирани CLI инструменти за инсталиране на един инструмент или използване на собствена инсталация.

grok се инсталира чрез пакета grok от първа страна на mise, по същия начин като claude и codex. Изпълнете grok или го изберете под Setup > Defaults > Agent. Пропуснете инсталатора curl | bash на x.ai. Този път поставя второ копие в ~/.grok/bin, добавя го в началото на PATH и презаписва обвивката на Omarchy.

dsh отваря своя браузърен интерфейс на 127.0.0.1:3080, като директорията на стартиране е работното му пространство по подразбиране. Неговият браузърен интерфейс не приема начална подкана, така че omarchy agent prompt го отваря с подканата в клипборда ви за поставяне. Omarchy го стартира с предварително зададената настройка за разрешения без одобрение на DeepSeek. DeepSeek Harness качва регистрационни файлове на сесиите в DeepSeek, когато използвате официалния му API за модели; изключете това под Settings > General > Upload Session Log в неговия браузърен интерфейс. Обратната връзка, която му изпращате, също се качва заедно със сесията, освен ако не го стартирате с DSH_TELEMETRY_MODE=DISABLED.

Агентът по подразбиране

Изберете своя агент по подразбиране с omarchy default agent <name> или под Setup > Defaults > Agent в менюто на Omarchy (Super + Space). Ако агентът все още не е инсталиран, избирането му първо го инсталира. Чисто нова инсталация на Omarchy ще ви покани да направите този избор с еднократно известие.

Избирането на Claude също се опитва да настрои неговото разширение за браузър за Chromium, Chrome, Brave, Brave Origin и Edge. Настройката на разширението се прилага за всички потребители и може да поиска системната ви парола; отмяната или неуспешното инсталиране на разширението все пак избира и стартира Claude. Рестартирайте браузъра си, активирайте разширението, ако бъдете подканени, и влезте в Claude, за да завършите свързването му. Изпълнете /chrome в Claude, за да проверите връзката. Firefox и Zen не поддържат това разширение. Ако Claude вече е бил вашият агент по подразбиране, преди да бъде добавена тази настройка, изберете го отново, за да инсталирате разширението.

След като сте избрали, Super + Shift + Ctrl + A стартира агента по подразбиране в отделен прозорец на терминала (или показва изборника, ако все още не сте избрали). Можете също да го стартирате направо в задача с omarchy agent prompt "Review this project". Freebuff и DeepSeek Harness не приемат начална подкана, така че вместо това се отварят с подканата в клипборда ви за поставяне. Агентите, стартирани по този начин, работят без надзор в съответните си режими да не спират да питат, така че бъдете готови те наистина да вършат неща! MiniMax Code няма такъв режим за интерактивните си сесии, така че той иска разрешения както обикновено. И тъй като агентите отказват да запомнят доверие за домашната ви директория, стартиранията от $HOME започват вместо това в ~/Work.

Има и терминални преки пътища: a изпълнява агента по подразбиране вградено в текущия терминал, докато c, cx и cy стартират директно OpenCode, Claude Code и Codex (отново в режимите им за автоматично одобряване). Промените на темата също се синхронизират с агентите: Claude Code, Pi, OpenCode и Hermes (след като Omarchy го е инсталирал) ви следват, когато сменяте темата на Omarchy.

Панелът с агенти

Горната лента има икона за агенти. Преди да сте настроили агент, неговият панел ви превежда през влизане в Claude, Codex или Grok, а първият става вашият агент по подразбиране. След това панелът поставя всеки абонамент на една страница: всеки агент и акаунт с неговия план, измервателен уред за всеки от неговите 5-часови сесийни и седмични лимити с времето до нулирането му (задръжте за точния процент) или оставащия предплатен баланс, под ред, който се върти през това, което сте използвали във всички тях, като токени тази седмица и най-использвания ви модел. Под Make something той предлага начални подкани за нова тема, плъгин или приложение, които предават задачата на вашия агент по подразбиране. Приложенията се изграждат по начина, по който са изградени собствените на Omarchy Hype, Monologue и Omacut, на C++ и Qt Quick, следвайки умението за агенти omarchy-app, а компилаторът и частите от Qt, от които се нуждаят, идват инсталирани. Claude Code, Codex, Grok, Kimi, Cursor и неговият кредит за Grok Bot, GitHub Copilot, Muse, Antigravity, Kimchi и Devin са покрити от кутията с техните лимити, а Hermes, Mistral Vibe и Qwen Code показват своите сесии и токени, след като сте ги използвали. Плановете и ключовете на доставчици, които използвате чрез pi, omp или opencode, също се показват: OpenCode Zen и Go, Z.ai GLM Coding Plan, Ollama Cloud, MiniMax Token Plan и Synthetic с техните лимити; Fireworks, OpenRouter и DeepSeek с техните предплатени баланси; и моделите, които изпълнявате на собствения си хардуер, под Local models. Всеки агент се брои веднъж, при този, който го таксува, независимо през колко обвивки го управлявате.

Щракнете с левия бутон върху иконата в лентата за панела, с десния бутон, за да стартирате вашия агент по подразбиране. Записите за използване зад него се регенерират на всеки 15 минути от omarchy agent usage-update, а панелът може дори да обединява използване от другите ви машини чрез синхронизирана папка. Вижте README под $OMARCHY_PATH/shell/plugins/agents/ за пълните настройки.

Няколко абонамента

Ако плащате за повече от един план на Claude, Codex или Grok - личен Max и служебен, да речем - Omarchy може да ги държи всички влезли и да се движи между тях. Добавете абонамент с + в панела с агенти, който ви превежда през това точно там, или с omarchy agent account add claude Work (или codex, или grok). Той инсталира CLI, ако липсва. Първият акаунт за доставчик влиза през нормалния ви браузър, точно там, където CLI винаги търси. Всеки следващ влиза през частен прозорец, така че акаунтът, в който браузърът ви вече е влязъл, да не бъде избран по погрешка; влезте там като акаунта, който добавяте, и първо затворете всеки частен прозорец, който вече сте отворили. Никога не излизайте от CLI, за да направите това: излизането отменя запазеното влизане и този акаунт ще трябва да бъде добавен отново.

За да копирате влизанията за абонаментите си на друга машина с Omarchy през SSH, изпълнете omarchy agent account copy user@laptop. Изпращачът предоставя временен приемник, когато местоназначението няма инсталиран такъв, така че по-стари машини с Omarchy могат да получават акаунти без актуализация. Инсталираните приемници имат предимство. Това копира всички абонаменти за Claude, Codex и Grok; добавете имена на доставчици, за да ги изберете, както в omarchy agent account copy laptop claude. Имената на акаунтите и идентификаторите на командите съвпадат с източника, включително акаунти, които вече присъстват на местоназначението. Несвързани акаунти на местоназначението получават числов суфикс, ако имената им са в конфликт, а настройките, уменията, плъгините и историята на разговорите остават локални за всяка машина.

Съществуващите идентификационни данни на местоназначението се запазват. Акаунт от източника, който вече е влязъл там, има синхронизирано името си, без да се заменят идентификационните му данни; други акаунти се добавят до него. За да замените запазените идентификационни данни за съответстващи акаунти, използвайте omarchy agent account copy --replace laptop claude, след като излезете от сесиите на този акаунт на местоназначението. Ново местоназначение също получава активния акаунт и предпочитанията за превключване на източника; установено местоназначение запазва своите собствени.

Идентификационните данни пътуват през SSH и се съхраняват в частни файлове на местоназначението, така че копирайте само на машини, на които имате доверие. Това е еднократно копие, а не текуща синхронизация. Токените за обновяване на Codex могат да бъдат ротирани от друга машина, оставяйки копирано влизане в нужда от подновяване; отделните влизания остават най-надеждният избор за едновременно използване на няколко машини. Вижте указанията за удостоверяване на акаунти на Codex.

Един акаунт на доставчик е активен и всяка нова сесия започва като него: cx, cy, обикновен claude, codex или grok, всичко, стартирано чрез omarchy agent, и скриптове или редактори, които намират CLI в PATH. Превключете с omarchy agent account use work (и обратно с omarchy agent account use main) или в панела, като натиснете номера на акаунт и след това Enter (или щракнете неговия бутон Use). Сесиите, които вече работят, остават на акаунта, с който са започнали. Историята на разговорите, настройките, уменията и плъгините се споделят между акаунтите, така че claude --continue в същата папка продължава оттам, където сте спрели на новия акаунт.

С повече от един акаунт панелът показва лимитите на всеки акаунт един до друг, като активният е маркиран. По подразбиране Omarchy ви уведомява, когато активният акаунт премине 95% от лимит, а щракването върху известието превключва към акаунта с най-много резерв. Задръжте върху реда на акаунт в панела и щракнете Autoswitch, което се появява до Use (или натиснете m), или изпълнете omarchy agent account mode auto, за да превключва самостоятелно вместо това; докато е включено, Autoswitch заема мястото на Use, а щракването му отново се връща към уведомяване. Добавете число, за да промените прага, както в omarchy agent account mode auto 90. Ако всеки акаунт е над прага, ще чуете за това веднъж, заедно с това кой акаунт ще се освободи пръв. Докато активен акаунт е в рамките на 15 точки от прага си (80% при настройката по подразбиране), неговите лимити се проверяват на всеки три минути, а не на всеки 15.

omarchy agent account list показва всеки акаунт и най-новите му лимити, omarchy agent account remove work забравя един, а omarchy agent account rename primary Hey преименува един (или щракнете името на акаунт в панела). Тези команди работят върху акаунтите на вашия агент по подразбиране; за да достигнете другия доставчик, първо го именувайте, както в omarchy agent account use codex side. Влизането, което вече имахте в ~/.claude или ~/.codex, е акаунтът Main и остава където е. Акаунт, оставен неизползван повече от около осем часа, може да покаже Sign-in required; щракнете го, за да влезете отново с този акаунт точно в панела, или стартирайте сесия в него, което обновява влизането само по себе си. MCP сървърите, които сте имали, когато акаунт е бил добавен, идват заедно с него, но тези, които добавите по-късно с claude mcp add, достигат само акаунта, в който сте ги добавили. Claude Desktop и инструменти, конфигурирани с абсолютен път до CLI двоичен файл, не следват превключването. Изричен CLAUDE_CONFIG_DIR, CODEX_HOME или GROK_HOME има предимство пред избрания акаунт.

Диагностика на сривове

Omarchy наблюдава systemd-coredump за сривове на процеси. Когато нещо сегфолтне, ще получите известие „Process crashed“ - щракнете го и сривът се предава на вашия агент по подразбиране заедно с умението diagnose-crash на Omarchy, което превежда агента през установяване на фактите от дъмпа на ядрото и решаване дали сривът си заслужава да бъде докладван нагоре по веригата. Можете също да го изпълните ръчно срещу всеки PID от coredumpctl list с omarchy agent crash <pid>.

Наблюдението е включено по подразбиране. Изключете го под Trigger > Toggle > Crash Capture (или с omarchy toggle crash-capture) и известията спират; omarchy agent crash <pid> все още работи ръчно.

Сривовете също могат да бъдат заглушени по една програма наведнъж, което е това, което диагнозата ви предлага накрая. omarchy crash mute hyprland спира известията само за тази програма, omarchy crash mute hyprland off ги връща обратно, а omarchy crash mute самостоятелно изброява какво сте заглушили. То приема пътя на двоичния файл също толкова охотно, колкото името му, така че omarchy crash mute /usr/bin/hyprland прави същото нещо. Цитирайте име с интервал в него, както в omarchy crash mute 'Some App'. Всичко останало все още уведомява, а заглушената програма все още се срива - това скрива напомнянето, не поправя нищо.

Настолни приложения

Менюто Install > AI също носи няколко графични AI приложения: настолното приложение ChatGPT, настолното приложение Claude (бета версията за Linux на Anthropic, с раздели Chat, Cowork и Claude Code), Grok Bot за чат с моделите на xAI, Hermes Desktop, OpenClaw, настолното приложение Perplexity и T3 Code. Grok Bot е настолното чат приложение. Кодиращият агент е командата grok.

Hermes Desktop е този, който трябва да познавате, защото една машина има един Hermes и той е на приложението: Hermes се инсталира само и единствено чрез приложението, а командата hermes, която агентът по подразбиране изпълнява, е на приложението. Избирането на Hermes като агент по подразбиране инсталира същото нещо, което прави записа Install > AI: пакета и среда за изпълнение на Hermes под ~/.hermes, настроена от собствения инсталатор на Hermes, което отнема няколко минути първия път. Тази среда за изпълнение е единственият Hermes, който използват терминалната команда hermes, агентът по подразбиране и приложението, и тя се актуализира сама с hermes update, а не чака издание на Omarchy. Инсталирането ѝ също предоставя на Hermes темата на Omarchy като скин с име omarchy, която всяка повърхност на Hermes следва, докато сменяте темите; изберете друга под настройките Appearance на Hermes или с /skin, ако предпочитате да не го прави, и Omarchy оставя този избор на мира. Премахването на приложението под Remove > AI първо затваря Hermes, включително шлюза, взима тази среда за изпълнение със себе си и запазва вашите чатове, спомени и уменията, които Hermes е написал за себе си, освен ако не му кажете друго: то пита, с отговор по подразбиране не, дали тези данни и настройките ви за връзка също трябва да изчезнат.

Настолното изживяване на OpenClaw е неговият Control UI, който се отваря като уеб приложение, поддържано от собствения му локален шлюз. OpenClaw живее в ~/.openclaw и се актуализира сам: използвайте бутона „Update Gateway“ в Control UI или изпълнете openclaw update, и шлюзът се рестартира на новата версия. Omarchy избира само изданието, от което започва нова инсталация. Премахването на OpenClaw под Remove > AI взима услугата на шлюза и приложението със себе си и след това пита дали ~/.openclaw също трябва да изчезне, тъй като там се държат вашите чатове и идентификационни данни заедно със самия OpenClaw и средите за изпълнение на плъгини, които той изтегля; настройката по подразбиране го запазва, а инсталирането на OpenClaw отново го взима обратно.

T3 Code работи от официалното си издание AppImage в ~/.local/share/t3code, а не от пакет, така че се актуализира сам. Инсталирането му пита дали да започнете на канал Stable или Nightly; превключете по-късно в настройките на T3 Code. Вашите нишки и настройки живеят в ~/.t3, а премахването на T3 Code под Remove > AI ги взима със себе си.

Локални LLM

Omarchy препоръчва два начина за изпълнение на локални LLM модели: LM Studio и Ollama. LM Studio предоставя GUI интерфейс за намиране на модели с отворени тегла, инсталирането им и изпълнението им. Това е чудесен начин да започнете лесно. Ollama предлага CLI за правене на същото по подобен начин. Но ако сте нов в локалните модели, аз бих започнал с LM Studio. Можете да инсталирате който и да е от тях под Install > AI в менюто на Omarchy.

Умението Omarchy

Уменията за агенти помагат на AI да използва конкретни инструменти по конкретен начин, а Omarchy се доставя с умение по подразбиране за приспособяване на системата. Като настройване на вашата конфигурация на Hyprland, регулиране на лентата или дори създаване на нова тема от нулата. То е свързано чрез символна връзка в директориите за умения за Claude Code (~/.claude/skills), Codex (~/.codex/skills), Pi (~/.pi/agent/skills), Antigravity (~/.gemini/config/skills), Hermes (~/.hermes/skills и всеки ~/.hermes/profiles/*/skills) и общото местоположение ~/.agents/skills, така че повечето обвивки го взимат автоматично.

Но трябва да третирате това умение като експериментално. Различните модели ще го използват с различен ефект. Най-добре е първо да работите в режим на планиране, така че да имате представа какво би искал да промени агентът. И след това бъдете готови да върнете промени или дори да извикате omarchy reinstall configs, ако агентът направи бъркотия от всичко.