Посібник
AI
Omarchy містить засоби запуску для перелічених нижче агентів кодування, не обираючи за вас агента за замовчуванням. Запустіть команду, щоб встановити її CLI під час першого використання, а потім автентифікуйтеся, коли з’явиться відповідний запит. Hermes є винятком: під час його першого використання для нього нічого не встановлюється, а його вибір встановлює Hermes Desktop, як пояснюється нижче в розділі Desktop apps.
| Команда | Агент |
|---|---|
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, harness від OpenRouter |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code, агент кодування Alibaba |
ori стоїть окремо: він запускає інші harness проти всього каталогу моделей 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 відкриває свій браузерний UI на 127.0.0.1:3080, де каталог запуску є його робочим простором за замовчуванням. Його браузерний UI не приймає початкового запиту, тож omarchy agent prompt відкриває його із запитом у вашому буфері обміну, щоб ви вставили його. Omarchy запускає його з попереднім набором дозволів DeepSeek без схвалення. DeepSeek Harness завантажує журнали сесій до DeepSeek, коли ви використовуєте його офіційний API моделей; вимкніть це в його браузерному UI в 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 вона пропонує початкові запити для нової теми, плагіна або застосунку, які передають завдання вашому агенту за замовчуванням. Застосунки створюються так само, як власні Hype, Monologue і Omacut від Omarchy, на 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. Кожен агент рахується один раз, за тим, хто виставляє за нього рахунок, незалежно від того, через скільки harness ви ним керуєте.
Клацніть лівою кнопкою миші значок на панелі, щоб відкрити панель, клацніть правою кнопкою, щоб запустити свого агента за замовчуванням. Записи про використання, що стоять за нею, повторно створюються кожні 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 (або клацнувши його кнопку 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 щодо аварійних завершень процесів. Коли щось спричиняє segfault, ви отримаєте сповіщення “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 beta від 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, тож більшість harness підхоплюють її автоматично.
Але вам слід ставитися до цієї навички як до експериментальної. Різні моделі використовуватимуть її з різним ефектом. Найкраще спершу запускати її в режимі планування, щоб ви мали уявлення про те, що агент хотів би змінити. А потім будьте готові відкотити зміни або навіть викликати omarchy reinstall configs, якщо агент наробить усього безладу.