omux：macOS 多智能体会话终端

项目简介

omux 是一款原生 macOS 终端，用 Swift 和 SwiftTerm 编写，不使用 Electron 或 WebView，安装包约 5 MB，启动很快。它把多个 Claude Code 和 Codex 会话放在同一个窗口里管理：告诉你哪个会话正在等你，允许你直接从侧边栏回答，并让每个会话拥有自己的分支。

主要功能

• 项目与会话：一个项目即一个文件夹加一个默认 agent，会话挂在项目下，可拖动排序、重命名、上色、在项目间移动。
• 会话可恢复：每个 Claude Code 会话保留自己的 session ID，每个 Codex 会话保留自己的 thread，重启或重新打开应用后回到完全相同的对话。
• 实时状态：按会话显示正在工作、需要你或已完成；Dock 徽标统计等待中的会话，通知可带你跳到对应会话。
• 侧边栏允许/拒绝：Claude Code 的工具权限和 Codex 的审批都能直接在会话上点 Allow 或 Deny，拒绝时还能告诉 agent 换个做法。
• 窗格：同一项目的会话可在窗口内向右/向下拆分、从侧边栏拖到边缘、缩放、移动、最大化，每个项目的布局会被保存。
• omux 命令：会话中的程序可以列出项目的会话、读取它们的屏幕、启动新会话并向其发送文本；作用域限定在本项目、仅限子会话，每个操作都会以横幅提示。详见 docs/cli.md。
• 子代理：列出 Claude Code 或 Codex 的每个子代理及其当前工具，点击即可查看其对话记录。
• Worktree 会话（⌥⌘T）：会话拥有独立的分支和文件夹，并行 agent 互不干扰；可先执行每个项目自己的初始化命令。
• Pull Request 状态：配合 GitHub CLI 在会话旁显示检查、评审和合并状态，失败的检查日志可一键发给 agent；PR 合并后会提示清理 worktree。
• Changes（⌥⌘2）：查看会话相对基线的 diff，点击某一行留下批注，再把所有批注作为一条消息发给 agent。
• Files（⌥⌘1）：浏览会话所在文件夹，预览代码、Markdown、图片、PDF 以及 Quick Look 支持的格式；在终端里 ⌘ 点击路径也可预览。
• Browser（⌥⌘3）：每个会话一个 Web 视图，自动打开会话打印的本地服务地址；可选取页面元素，把它的 HTML、样式和截图发送到提示词。
• 提示词里带图片与文件：粘贴图片或把文件拖到终端，agent 会收到它们的路径作为附件。
• 最近会话（⇧⌘O）：把 Claude Code 和 Codex 的最近对话重新打开为会话。
• 用量限制：侧边栏底部显示所选服务商的套餐用量。
• 其他：自定义通知声音、主题、终端字体，快速切换（⌘K），签名自动更新；Finder 的「Open in omux」、把文件夹拖到 Dock 图标或 open -a omux <folder> 都能打开文件夹。

安装与使用

从 latest release 下载 omux-<version>.dmg，打开后把 omux 拖进 Applications。应用使用 Developer ID 签名并已公证，可直接打开。

也可以自行构建（会安装到 /Applications）：

./build.sh
open /Applications/omux.app

运行环境要求：

• Apple Silicon Mac，macOS 14 或更高版本
• Claude 会话需要安装 claude；纯 shell 会话不需要
• Codex 会话需要 Codex CLI 0.165.0 或更高版本，命令名为 codex
• 从源码构建需要 Swift 6.2 或更高（Xcode 26 或命令行工具）

常用快捷键：⌘T 新建会话、⇧⌘T 新建 shell、⇧⌘N 新建项目、⌥⌘T 在 worktree 中新建会话、⌘K 跳转会话、⌥⌘1 / ⌥⌘2 / ⌥⌘3 切换 Files / Changes / Browser。

注意事项

• omux 不含遥测。它只在三处联网：读取套餐用量限制（使用 Keychain 中 Claude Code 自己的登录信息）、通过 gh 获取 Pull Request 状态、每天向 omux.app 检查更新；不会发送关于你或你的机器的信息。
• omux 是独立项目，与 Anthropic、OpenAI 无隶属或背书关系；Claude 和 Claude Code 是 Anthropic 的商标。
• 许可证为 MIT。

本作品整理自 GitHub 开源项目 onurozcan/omux，原作者 @onurozcan，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。