AI

Omarchy 将 AI 编码 agents 视为一等公民，但不会替你选定偏好。相反，每个主流编码 agent CLI 都预先配置为懒加载启动器。这些启动器是 ~/.local/bin/ 中由 mise 管理的微型存根，因此在你首次实际运行之前不会下载任何内容。Hermes 是例外：它没有预装存根，选择它会安装 Hermes Desktop，具体参见下方“桌面应用程序”。调用以下任意命令，并在提示时进行身份验证：

命令	Agent
claude	Claude Code
codex	OpenAI Codex
opencode	OpenCode
agy	Google Antigravity CLI
copilot	GitHub Copilot CLI
crush	Crush
grok	来自 xAI 的 Grok Build
pi	Mario Zechner’s Pi
omp	Oh My Pi
ori	Ori，OpenRouter 的 harness
hermes	Hermes，Nous Research 的 agent
muse	Muse Code，Meta 的编码 agent
cursor-agent	Cursor CLI

ori 是其中的异类：它让其他 harness 针对 OpenRouter 的整个模型目录运行，因此 ori claude、ori codex 或 ori opencode 会以你指定的任意模型启动那些 agents，而 ori code 则是 Ori 自己的 agent。

要以相同方式封装额外的 CLI，请运行 omarchy-mise-install <package> [command-name]。当你运行 omarchy update（或 mup 别名）时，这些存根会与 mise 管理的其他所有内容一起保持最新。

grok 与 claude、codex 一样，通过 mise 的第一方 grok 软件包安装。直接运行 grok，或在设置 > 默认应用 > Agent中选择它即可。不要使用 x.ai 上的 curl | bash 安装方式：它会在 ~/.grok/bin 中安装第二份副本，将其置于 PATH 最前面，并覆盖 Omarchy 的封装程序。

默认 agent

使用 omarchy default agent <name> 或在 Omarchy 菜单中的设置 > 默认应用 > Agent（Super + Space）下选择你的默认 agent。如果该 agent 尚未安装，选择它会先进行安装。全新的 Omarchy 会通过一次性通知邀请你做出此选择。

选择 Claude 时，还会尝试为 Chromium、Chrome、Brave、Brave Origin 和 Edge 配置它的浏览器扩展。扩展配置对所有用户生效，可能要求输入系统密码；即使取消或安装扩展失败，Claude 仍会被选为默认 agent 并启动。重启浏览器，按提示启用扩展，再登录 Claude 即可完成连接。在 Claude 中运行 /chrome 可以检查连接。Firefox 和 Zen 不支持此扩展。如果在加入这项配置功能之前，Claude 就已经是你的默认 agent，请重新选择一次以安装扩展。

Muse Code —— Meta 的 muse —— 像其他 agents 一样使用预装的 mise 存根。将其选为默认 agent 会通过 mise 的 HTTP 后端安装 Meta 的官方启动器。该启动器会验证并更新适用于你机器的原生二进制文件。

选定之后，Super + Shift + Ctrl + A 会在专用终端窗口中启动默认 agent（如果你尚未选择，则会弹出选择器）。你也可以使用 omarchy agent prompt "Review this project" 直接启动它执行任务。以这种方式启动的 agents 会在各自的不停下来询问模式下无人值守运行，所以请准备好它们真的会动手做事！而且由于 agents 拒绝为你的主目录记住信任，从 $HOME 启动时会改为在 ~/Work 中开始。

还有终端快捷键：a 在当前终端中内联运行默认 agent，而 c、cx 和 cy 则直接启动 OpenCode、Claude Code 和 Codex（同样处于自动批准模式）。主题更改也会同步到 agents：当你切换 Omarchy 主题时，Claude Code、Pi、OpenCode 和 Hermes（由 Omarchy 安装后）都会随之变化。

Agents 面板

顶部栏上有一个 agents 图标。在你尚未配置 agent 时，它的面板会引导你登录 Claude、Codex 或 Grok，第一个登录的 agent 会成为默认 agent。之后，面板会在同一页列出所有订阅：每个 agent 及账户的套餐、5 小时会话和每周限额的使用百分比，或剩余的预付费余额。上方一行会轮换显示各账户的汇总使用情况，例如本周 token 用量和最常用的模型。“动手创作”区域提供创建主题、插件或应用程序的起始提示词，并将任务交给你的默认 agent。应用程序会遵循 omarchy-app agent 技能，像 Omarchy 自己的 Hype、Monologue 和 Omacut 一样，使用 C++ 和 Qt Quick 构建；所需编译器和 Qt 组件已预装。Claude Code、Codex、Grok 和 Fireworks 均开箱即用。

左键点击栏图标打开面板，右键点击则启动你的默认 agent。其背后的使用记录每 15 分钟由 omarchy agent usage-update 重新生成，面板甚至可以通过同步文件夹合并来自你其他机器的使用数据。完整设置请参阅 $OMARCHY_PATH/shell/plugins/agents/ 下的 README。

多个订阅

如果你付费订阅了多个 Claude、Codex 或 Grok 套餐，例如个人和工作各有一个 Max 订阅，Omarchy 可以保留所有账户的登录状态，并在它们之间切换。点击 agents 面板中的加号，即可在面板内按引导添加订阅；也可以运行 omarchy agent account add claude Work（或将提供商改为 codex、grok）。如果尚未安装对应 CLI，会先安装。每个提供商的第一个账户通过常规浏览器登录，登录信息保存在该 CLI 通常使用的位置。之后添加的账户则通过隐私窗口登录，以免误用浏览器当前登录的账户；请先关闭已有的隐私窗口，再在新窗口中登录你要添加的账户。不要为此在 CLI 中注销登录：注销会撤销保存的登录状态，之后必须重新添加该账户。

每个提供商同时只有一个活跃账户，新会话都会使用它，包括通过 cx、cy、直接运行 claude、codex 或 grok、通过 omarchy agent 启动的会话，以及通过 PATH 找到 CLI 的脚本或编辑器。使用 omarchy agent account use work 切换账户，用 omarchy agent account use main 切回；也可以在面板中按账户编号后按 Enter，或点击该账户的“使用”按钮。已经运行的会话仍使用启动时的账户。对话历史、设置、技能和插件由各账户共享，因此切换账户后，在同一文件夹中运行 claude --continue，仍可继续之前的对话。

存在多个账户时，面板会并排列出各账户的限额，并标记当前活跃账户。默认情况下，活跃账户的任一限额使用率超过 95% 时，Omarchy 会发出通知；点击通知即可切换到剩余额度最多的账户。若希望自动切换，可以将鼠标悬停在账户行上，点击“使用”旁出现的“自动切换”（或按 m），也可以运行 omarchy agent account mode auto。启用后，“自动切换”会取代“使用”按钮，再次点击即可恢复为仅通知。命令后附加数字可调整阈值，例如 omarchy agent account mode auto 90。如果所有账户都超过阈值，系统会通知一次，并告知哪个账户会最先恢复可用额度。当活跃账户距离阈值不足或等于 15 个百分点时（默认阈值下为使用率达到 80%），其限额检查间隔会从每 15 分钟缩短为每 3 分钟。

omarchy agent account list 列出所有账户及最新限额，omarchy agent account remove work 移除一个账户，omarchy agent account rename primary Hey 重命名账户（也可在面板中点击账户名称）。这些命令默认操作当前默认 agent 的账户；若要操作其他提供商，先写明提供商，例如 omarchy agent account use codex side。你原先保存在 ~/.claude 或 ~/.codex 中的登录对应“主账户”，仍保留在原位置。超过约 8 小时未使用的账户会显示最后一次已知的限额，直到再次在该账户中运行会话。添加账户时，已有的 MCP 服务器会随之带入；但之后通过 claude mcp add 添加的服务器，只会加入执行该命令时使用的账户。Claude Desktop 以及使用 CLI 二进制文件绝对路径配置的工具不会随之切换。显式设置的 CLAUDE_CONFIG_DIR、CODEX_HOME 或 GROK_HOME 优先于所选账户。

崩溃诊断

Omarchy 会监视 systemd-coredump 以发现进程崩溃。当某个进程发生段错误时，你会收到一条“Process crashed”通知——点击它，崩溃信息会连同 Omarchy 的 diagnose-crash 技能一起交给你的默认 agent，该技能会引导 agent 从核心转储中确立事实，并判断该崩溃是否值得向上游报告。你也可以使用 omarchy agent crash <pid> 从 coredumpctl list 中针对任意 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'。其他所有内容仍会发出通知，被静音的程序仍会崩溃——这只是隐藏提醒，并不能修复任何问题。

桌面应用程序

安装 > AI 菜单还包含几个图形化 AI 应用程序：ChatGPT 桌面应用程序、Claude 桌面应用程序（Anthropic 的 Linux 测试版，带有 Chat、Cowork 和 Claude Code 标签页）、用于与 xAI 模型聊天的 Grok Bot、Hermes Desktop、OpenClaw 以及 Perplexity 桌面应用程序。Grok Bot 是桌面聊天应用程序，编码 agent 则是 grok 命令。

Hermes Desktop 值得特别了解，因为一台机器上只有一个 Hermes，而且它属于这个应用程序：Hermes 始终通过应用程序安装，默认 agent 运行的 hermes 命令也由该应用程序提供。选择 Hermes 作为默认 agent，与使用安装 > AI中的对应入口安装的内容相同：Hermes 软件包，以及由 Hermes 自带安装程序在 ~/.hermes 下配置的运行时，首次安装需要几分钟。终端 hermes 命令、默认 agent 和桌面应用程序都使用这一份运行时；它通过 hermes update 自行更新，无需等待 Omarchy 发布新版本。安装时还会将 Omarchy 主题作为名为 omarchy 的皮肤交给 Hermes，切换主题时，所有 Hermes 界面都会随之变化；如果不希望同步，可以在 Hermes 的外观设置中或通过 /skin 选择其他皮肤，Omarchy 会保留你的选择。在移除 > AI中卸载应用程序时，会先关闭 Hermes（包括网关），然后移除运行时。聊天、记忆以及 Hermes 为自己编写的技能默认保留；系统会询问是否同时删除这些数据和连接设置，默认选择为否。

OpenClaw 的桌面界面是 Control UI，以 Web 应用程序的形式打开，由自己的本地网关提供支持。OpenClaw 位于 ~/.openclaw 中，并自行更新：点击 Control UI 的“更新网关”按钮或运行 openclaw update，网关就会以新版本重启。Omarchy 只决定全新安装时使用的初始版本。在移除 > AI中移除 OpenClaw，会一并移除网关服务和应用程序，然后询问是否删除 ~/.openclaw。其中既保存聊天和凭据，也包含 OpenClaw 本体及其下载的插件运行时；默认会保留该目录，再次安装 OpenClaw 时会继续使用其中的内容。

本地 LLM

Omarchy 推荐两种运行本地 LLM 模型的方式：LM Studio 和 Ollama。LM Studio 提供 GUI 界面，用于查找开放权重模型、安装它们并运行它们。这是轻松上手的好方法。Ollama 提供 CLI 以类似方式完成这些操作。但如果你是本地模型的新手，我会从 LM Studio 开始。你可以在 Omarchy 菜单的 安装 > AI 下安装其中任意一个。

Omarchy 技能

Agent 技能帮助 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 会自动识别它。

但你应该将此技能视为实验性的。不同的模型会以不同的效果使用它。最好先在 plan 模式下运行，这样你就能了解 agent 想要更改什么。然后准备好回滚更改，甚至在 agent 把一切搞得一团糟时调用 omarchy reinstall configs。