AI 与 Coding Agent

Omarchy 将 AI Coding Agent 视为系统的一等公民，但不会替你做单一的选择。相反，所有主流的 Coding Agent CLI 工具都预置为了懒加载启动器。这些启动器是 ~/.local/bin/ 中由 mise 管理的轻量存根 (Stub)，直到你首次运行其中某一个工具时才会真正开始下载。直接调用其中任意一个并按提示完成身份认证即可：

若想以相同方式封装其他 CLI 工具，可运行 omarchy-mise-install <package> [command-name]。当你运行 omarchy update（或 mup 别名）时，这些存根会与 mise 管理的其他工具一同保持最新状态。

默认 Agent (The default agent)

通过 omarchy default agent <name> 或在 Omarchy 菜单 (Super + Space) 中的 Setup > Defaults > Agent 可以指定你的默认 Agent。如果该 Agent 尚未安装，选择它会自动触发安装。首次启动崭新的 Omarchy 系统时，系统会弹出一次性通知引导你做出此项选择。

选定之后，按下 Super + Shift + Ctrl + A 即可在一个专用终端窗口中启动默认 Agent（如果尚未选择过则会弹出选择器）。你也可以直接通过 omarchy agent prompt "Review this project" 启动它直接执行特定任务。通过此方式启动的 Agent 会在各自的无人值守免确认模式下运行，请准备好让它们自主执行操作！此外，为了避免 Agent 记住对用户根目录的信任权限，从 $HOME 发起的启动会自动以 ~/Work 作为初始工作目录。

终端中也提供了便捷别名：在当前终端中直接输入 a 可以内联运行默认 Agent，而 c、cx 和 cy 则分别直接启动 OpenCode、Claude Code 和 Codex（同样处于自动批准模式）。主题切换也会实时同步到 Agent：当你切换 Omarchy 主题时，Claude Code、Pi 和 OpenCode 都会随之自动应用协调的配色方案。

状态栏 Agent 监控面板 (The agents panel)

当系统首次检测到机器上有 AI 编程工具的使用记录时，顶部状态栏会自动出现一个 Agent 图标（此前保持隐藏以避免界面繁杂）。点击该图标展开的面板可以在一个地方集中追踪所有订阅：你的套餐计划、5 小时会话窗口 (5-hour session) 和周限额的使用百分比（或剩余预付费余额），以及按天和按模型细分的 Token 消耗统计。Claude Code、Codex 和 Fireworks 均已开箱支持。

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

进程崩溃智能诊断 (Crash diagnosis)

Omarchy 会实时监听 systemd-coredump 捕获的进程崩溃事件。当某个程序发生段错误 (Segmentation Fault / Segfault) 时，你会收到一条“进程崩溃 (Process crashed)”的系统通知 —— 点击该通知，崩溃信息将连同 Omarchy 的 diagnose-crash 技能一起移交给你的默认 Agent。该技能会引导 Agent 分析核心转储 (Core Dump) 的关键事实，并评估该崩溃是否值得向上游反馈报告。你也可以在终端中通过 coredumpctl list 获取 PID 后手动运行诊断：omarchy agent crash <pid>。

该监听机制默认开启。如果你希望关闭，可以在 Trigger > Toggle > Crash Capture 下关闭（或运行 omarchy toggle crash-capture），之后将不再弹出崩溃通知；但你依然可以随时手动执行 omarchy agent crash <pid>。

桌面图形应用 (Desktop apps)

Install > AI 菜单中还提供了几款图形界面的 AI 应用：ChatGPT 官方桌面应用，以及用于与 xAI 模型交流的 Grok Bot。

本地大模型 (Local LLMs)

Omarchy 推荐两种运行本地 LLM 模型的方式：LM Studio 与 Ollama。LM Studio 提供了美观的图形界面，用于发现开源权重模型、安装并运行它们，是快速入门的最佳选择。Ollama 则提供了类似的命令行交互体验。如果你是首次接触本地大模型，建议从 LM Studio 开始尝试。两者均可在 Omarchy 菜单中的 Install > AI 下一键安装。

Omarchy Agent 技能 (The Omarchy Skill)

Agent 技能 (Skill) 能指导 AI 以特定方式调用特定工具，Omarchy 自带了一个专门用于系统定制的官方技能。例如调整你的 Hyprland 配置、定制状态栏，甚至从零创建一套全新的主题方案。该技能已软链接到各大 Agent 的技能目录中：Claude Code (~/.claude/skills)、Codex (~/.codex/skills)、Pi (~/.pi/agent/skills)、Antigravity (~/.gemini/config/skills) 以及通用的 ~/.agents/skills，因此大多数工具都能自动识别并加载它。

不过，你应该将此技能视为实验性功能。不同的大模型使用它的效果会有所差异。建议先在 Plan 模式 (Plan Mode) 下运行，以便先了解 Agent 打算做出的修改。如果 Agent 意外搞乱了配置，随时准备好回滚更改，甚至可以通过在终端运行 omarchy reinstall configs 重新恢复官方配置。