AI
本文译自 The Omarchy Manual — AI，同步自 basecamp/omarchy@ed7bae4。术语以 TERMS.md 为准。
Omarchy 把 AI 编程 Agent 当作一等公民，但并不替你站队。所有主流编程 Agent CLI 都预接线成了懒加载启动器。这些启动器是 ~/.local/bin/ 下由 mise 管理的小桩（stub），第一次真正运行之前什么都不会下载。调用以下任意命令，按提示完成认证即可：
| 命令 | Agent |
|---|---|
claude |
Claude Code |
codex |
OpenAI Codex |
opencode |
OpenCode |
agy |
Google Antigravity CLI |
copilot |
GitHub Copilot CLI |
crush |
Crush |
grok |
xAI 的 Grok CLI |
pi |
Mario Zechner's Pi |
omp |
Oh My Pi |
想以同样方式包装其他 CLI，运行 omarchy-mise-install <package> [command-name]。运行 omarchy update（或别名 mup）时，这些桩会与 mise 管理的其他东西一起保持最新。
默认 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：Claude Code、Pi 和 OpenCode 都会跟随 Omarchy 主题变化。
Agents 面板
Omarchy 首次在机器上发现 AI 编程用量后，顶栏会长出一个 agents 图标（在那之前绝不碍事）。其背后的面板把每个订阅集中在一处：你的套餐、5 小时会话与每周限额的使用百分比（或剩余预付余额），以及按天、按模型的 token 用量。Claude Code、Codex 和 Fireworks 开箱即被支持。
左键点栏图标开面板，右键启动默认 Agent。背后的用量记录每 15 分钟由 omarchy agent usage-update 重新生成，面板甚至能经同步文件夹合并你其他机器的用量。完整设置见 $OMARCHY_PATH/shell/plugins/agents/ 下的 README。
崩溃诊断
Omarchy 监视 systemd-coredump 的进程崩溃。发生段错误（segfault）时你会收到「Process crashed」通知——点它，崩溃就会连同 Omarchy 的 diagnose-crash skill 一起交给默认 Agent，引导它从核心转储中确认事实，并判断这次崩溃是否值得上报上游。也可以对 coredumpctl list 里任意 PID 手动运行 omarchy agent crash <pid>。
监视默认开启。在 Trigger > Toggle > Crash Capture 关闭（或 omarchy toggle crash-capture）后通知即停；omarchy agent crash <pid> 仍可手动使用。
桌面应用
Install > AI 菜单还有几款图形化 AI 应用：ChatGPT 桌面版，以及用于和 xAI 模型聊天的 Grok Bot。
本地 LLM
Omarchy 推荐两种运行本地 LLM 的方式：LM Studio 和 Ollama。LM Studio 提供图形界面，用于查找开放权重模型、安装并运行它们，是轻松上手的好途径。Ollama 则提供做同样事情的 CLI。如果你是本地模型新手，我建议从 LM Studio 开始。两者都可在 Omarchy 菜单的 Install > AI 安装。
Omarchy Skill
Agent skill 能帮助 AI 以特定方式使用特定工具。Omarchy 自带一个定制系统的默认 skill：微调 Hyprland 配置、调整顶栏，乃至从零创建新主题。它以符号链接接入了 Claude Code（~/.claude/skills）、Codex（~/.codex/skills）、Pi（~/.pi/agent/skills）、Antigravity（~/.gemini/config/skills）以及通用的 ~/.agents/skills 目录，所以大多数 harness 会自动拾取它。
但请把这个 skill 当作实验性的。不同模型用它效果不一。最好先跑 plan 模式，了解 Agent 打算改什么；并且随时准备回滚更改，甚至在它搞得一团糟时祭出 omarchy reinstall configs。