Прескочи на садржај
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 при првој употреби, а затим се аутентификујте када то буде затражено. 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 Mario Zechner’s Pi
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. То укључује и остале Omarchy-јеве подразумеване CLI алате, као и агенте. Погледајте Унапред инсталирани CLI алати за инсталирање једног алата или коришћење сопствене инсталације.

grok је инсталиран преко mise-јевог званичног grok пакета, на исти начин као claude и codex. Покрените grok или га изаберите под Подешавање > Подразумевано > Агент. Прескочите curl | bash инсталатер на x.ai. Тај пут ставља другу копију у ~/.grok/bin, убацује је на почетак PATH-а и преписује Omarchy-јев омотач.

dsh отвара свој кориснички интерфејс у прегледачу на 127.0.0.1:3080, са директоријумом покретања као својим подразумеваним радним простором. Његов кориснички интерфејс у прегледачу не прима почетни упит, па omarchy agent prompt га отвара са упитом на вашој табли за исечке да бисте га налепили. Omarchy га покреће са DeepSeek-овим унапред подешеним скупом дозвола без одобравања. DeepSeek Harness отпрема дневнике сесија DeepSeek-у када користите његов званични API модела; искључите то под Подешавања > Опште > Отпреми дневник сесије у његовом корисничком интерфејсу у прегледачу. Повратне информације које му пошаљете такође се отпремају заједно са сесијом, осим ако га не покренете са DSH_TELEMETRY_MODE=DISABLED.

Подразумевани агент

Изаберите свог подразумеваног агента помоћу omarchy default agent <name> или под Подешавање > Подразумевано > Агент у 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 сати и недељно ограничење са временом до његовог ресетовања (задржите показивач за тачан проценат), или преостали унапред плаћени износ, испод реда који се смењује кроз оно што сте користили код свих њих, као што су токени ове недеље и ваш најчешће коришћени модел. Под Направи нешто нуди почетне упите за нову тему, додатак или апликацију који предају задатак вашем подразумеваном агенту. Апликације се граде на начин на који су грађени 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 са својим унапред плаћеним износима; и модели које покрећете на сопственом хардверу под Локални модели. Сваки агент се броји једном, код онога ко га наплаћује, без обзира на то кроз колико харнеса га покрећете.

Кликните левим тастером на икону на траци за панел, десним тастером да бисте покренули свог подразумеваног агента. Евиденције о коришћењу које стоје иза њега поново се генеришу сваких 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. Имена налога и ID-јеви команди подударају се са извором, укључујући налоге који већ постоје на одредишту. Неповезани одредишни налози добијају нумерички суфикс ако се њихова имена сукобљавају, а подешавања, вештине, додаци и историја разговора остају локални за сваку машину.

Постојећи одредишни акредитиви се чувају. Изворни налог који је тамо већ пријављен има своје име синхронизовано без замене његових акредитива; остали налози се додају уз њега. Да бисте заменили сачуване акредитиве за подударајуће налоге, користите 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 (или кликом на његово дугме Користи). Сесије које већ раде остају на налогу са којим су почеле. Историја разговора, подешавања, вештине и додаци деле се између налога, па claude --continue у истој фасцикли наставља тамо где сте стали на новом налогу.

Са више од једног налога, панел показује ограничења сваког налога једно поред другог, са означеним активним. Подразумевано вас Omarchy обавештава када активни налог пређе 95% ограничења, а клик на обавештење пребацује на налог са највише простора. Задржите показивач изнад реда налога у панелу и кликните на Аутоматска замена која се појављује поред Користи (или притисните m), или покрените omarchy agent account mode auto, да би се пребацивао сам уместо тога; док је укључена, Аутоматска замена заузима место дугмета Користи, а поновни клик на њу враћа на обавештавање. Додајте број да бисте променили праг, као у 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 је Главни налог и остаје тамо где је. Налог који се не користи више од око осам сати може да покаже Потребна је пријава; кликните на њега да бисте тај налог поново пријавили директно у панелу, или покрените сесију у њему, што само освежава пријаву. MCP сервери које сте имали када је налог додат долазе заједно са њим, али они које касније додате помоћу claude mcp add доспевају само до налога у коме сте их додали. Claude Desktop и алати конфигурисани са апсолутном путањом до CLI бинарне датотеке не прате пребацивање. Изричит CLAUDE_CONFIG_DIR, CODEX_HOME или GROK_HOME има предност над изабраним налогом.

Дијагностика пада

Omarchy прати systemd-coredump ради падова процеса. Када нешто направи грешку сегментације, добићете обавештење „Процес се срушио“ - кликните на њега, и пад се предаје вашем подразумеваном агенту заједно са Omarchy-јевом вештином diagnose-crash, која води агента кроз утврђивање чињеница из извода језгра и одлучивање да ли је пад вредан пријављивања узводно. Такође га можете покренути ручно на било који PID из coredumpctl list помоћу omarchy agent crash <pid>.

Праћење је подразумевано укључено. Искључите га под Окидач > Пребаци > Снимање падова (или помоћу 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'. Све остало и даље обавештава, а утишани програм се и даље руши - ово скрива подсетник, не поправља ништа.

Апликације за радну површину

Мени Инсталација > AI такође носи неколико графичких AI апликација: десктоп апликацију ChatGPT, десктоп апликацију Claude (Anthropic-ову Linux бета верзију, са картицама Chat, Cowork и Claude Code), Grok Bot за ћаскање са xAI-јевим моделима, Hermes Desktop, OpenClaw, десктоп апликацију Perplexity и T3 Code. Grok Bot је десктоп апликација за ћаскање. Агент за кодирање је команда grok.

Hermes Desktop је онај о коме треба да знате, јер машина има један Hermes, и он је од апликације: Hermes се икада инсталира само преко апликације, а команда hermes коју подразумевани агент покреће је од апликације. Избор Hermes-а као подразумеваног агента инсталира исту ствар коју ради ставка Инсталација > AI: пакет, и Hermes окружење за извршавање под ~/.hermes подешено Hermes-овим сопственим инсталатером, што први пут траје неколико минута. То окружење за извршавање је онај један Hermes који користе терминалска команда hermes, подразумевани агент и апликација, и оно се само ажурира помоћу hermes update, уместо да чека Omarchy издање. Његово инсталирање такође предаје Hermes-у Omarchy тему као кожу по имену omarchy, коју свака Hermes површина прати док мењате теме; изаберите другу под Hermes-овим подешавањима Изглед или помоћу /skin ако бисте радије да то не ради, и Omarchy оставља тај избор на миру. Уклањање апликације под Уклањање > AI прво затвара Hermes, укључујући и гејтвеј, узима то окружење за извршавање са собом, и чува ваша ћаскања, сећања и вештине које је Hermes написао за себе, осим ако му не кажете другачије: пита, са подразумеваним одговором не, да ли и ти подаци и ваша подешавања везе треба да оду.

OpenClaw-ово десктоп искуство је његов Control UI, који се отвара као веб апликација подржана његовим сопственим локалним гејтвејом. OpenClaw живи у ~/.openclaw и сам се ажурира: користите дугме „Ажурирај гејтвеј“ у Control UI-ју или покрените openclaw update, и гејтвеј се поново покреће на новој верзији. Omarchy само бира издање од ког свежа инсталација почиње. Уклањање OpenClaw-а под Уклањање > AI узима сервис гејтвеја и апликацију са собом, а затим пита да ли и ~/.openclaw треба да оде, пошто то држи ваша ћаскања и акредитиве поред самог OpenClaw-а и окружења за извршавање додатака која преузима; подразумевано га чува, а поновно инсталирање OpenClaw-а га поново преузима.

T3 Code се покреће из свог званичног AppImage издања у ~/.local/share/t3code, а не из пакета, па се сам ажурира. Његово инсталирање пита да ли да почне на каналу Stable или Nightly; пребаците касније у подешавањима T3 Code-а. Ваше нити и подешавања живе у ~/.t3, а уклањање T3 Code-а под Уклањање > AI их узима са собом.

Локални LLM модели

Omarchy препоручује два начина покретања локалних LLM модела: LM Studio и Ollama. LM Studio пружа GUI интерфејс за проналажење модела отворених тежина, њихово инсталирање и покретање. То је одличан начин да лако кренете. Ollama нуди CLI за слично чињење тога. Али ако сте нови у локалним моделима, ја бих кренуо од LM Studio-а. Можете инсталирати било који под Инсталација > 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, ако агент направи неред од свега.