一款带有侧边栏实时 AI agent 状态的 macOS 标签页分屏终端。按项目组织终端、自由拆分窗格，并随时一目了然地掌握 Claude Code、OpenCode 或 Codex 是正在运行、空闲还是在等待您的操作。 由采用 Metal GPU 渲染的 [ghostty](https://ghostty.org) 引擎驱动。双语 UI —— English / 简体中文。 ## 功能 - **工作区 → 标签页 → 分屏** — 按项目组织终端。每个工作区拥有自己的一组标签页；每个标签页都是一个分屏树，您可以进行水平或垂直切割、拖动分隔线以及使用键盘导航。 - **实时 AI agent 状态** — 侧边栏和标签页图标反映了 Claude Code、OpenCode 和 Codex 的 `running` / `idle` / `waiting-for-input` / `finished` 状态。每次轮次都会标记为成功或失败。将鼠标悬停在图标上可查看当前正在运行的工具，以及（针对 Claude / Codex）agent 上次回复的简短摘要。 - **工作区侧边栏元数据** — 每个工作区行显示其当前的 git 分支、开放的 PR 状态和未读通知 —— 每 5 秒在后台刷新一次，并通过您 shell 中的 OSC 钩子实时更新。 - **精美的主题** — 捆绑了所有 ghostty 主题。调整背景透明度、窗口模糊（vibrancy）、光标形状和闪烁，以及未聚焦窗格的变暗效果。MUX0 自身的侧边栏和标签栏会重新着色以匹配活动的终端主题 —— 没有突兀的界面元素。 - **双语 UI** — 完整的英文和简体中文。在 **Settings → Appearance → Language** 中切换，无需重启。 - **布局持久化** — 工作区列表、标签页列表、分屏布局以及每个终端的工作目录在重启后依然保留。 - **自动更新** — 由 Sparkle 提供支持的应用内更新。当新版本准备就绪时，侧边栏底部会出现一个圆点；更新说明会内联显示，您可以推迟或跳过任何版本。  ## 系统要求 - macOS 14.0 或更高版本 - 强烈推荐 Apple Silicon（用于 Metal GPU 渲染） ## 入门指南 ### 1. 安装 1. 从 [GitHub Releases](https://github.com/10xChengTu/mux0/releases) 下载最新的 `mux0.dmg`。 2. 打开 DMG 文件并将 **MUX0** 拖入您的 **Applications** 文件夹。 3. 启动 MUX0。首次启动时 macOS 可能会显示安全警告 —— 请前往 **System Settings → Privacy & Security** 并点击 **Open Anyway**。 此后，MUX0 每天会自动检查一次更新。当有新版本可用时，您会在侧边栏底部看到一个小圆点。 ### 2. 创建您的第一个工作区 1. 点击侧边栏中的 **＋** 按钮。 2. 选择一个项目文件夹 —— 这将成为该工作区的工作目录。 3. 侧边栏将立即开始跟踪该文件夹的 git 分支、PR 状态和通知。 提示：您可以添加任意数量的工作区。每个工作区都独立保留自己的标签页和分屏布局。 ### 3. 打开标签页和分屏窗格 - **新建标签页** — `⌘T`，或标签栏中的 **＋** 按钮。 - **关闭标签页** — `⌘W`，或标签页上的 ✕ 按钮。 - **水平分屏** — `⌘D`。 - **垂直分屏** — `⌘⇧D`。 - **在窗格之间移动焦点** — `⌘⌥` + 方向键。 - **调整大小** — 用鼠标拖动分隔线。 - **重命名标签页 / 工作区** — 双击标题。 - **重新排序** — 拖动标签页或工作区行。 ### 4. 选择主题 按 `⌘,` 打开 **Settings**，然后： - **Appearance → Theme** — 选择任意 ghostty 主题。侧边栏和标签栏会重新着色以匹配。 - **Appearance → Background Opacity** — 降至 1.0 以下可获得半透明窗口。 - **Appearance → Background Blur** — 与较低的透明度结合使用，可产生磨砂玻璃效果。 - **Font → Font Family / Font Size** — 选择您系统上的任意等宽字体。 有关所有设置，请参阅 [`docs/settings-reference.md`](docs/settings-reference.md)。 ### 5. 切换语言（可选） **Settings → Appearance → Language**：*System*（跟随 macOS 语言）、*English* 或 *简体中文*。更改将立即应用于整个 UI。 ## 在 MUX0 中使用 AI Agent MUX0 会自动接入 Claude Code、OpenCode 和 Codex，以便它们的状态实时显示在侧边栏和标签页图标上。您无需进行任何配置 —— 只需像往常一样运行 agent 即可。 ### 状态图标 | 图标颜色 | 含义 | |---|---| | 绿色（脉动） | Agent 正在运行 —— 正在进行一轮操作。 | | 琥珀色 | Agent 正在等待您的输入（权限请求、澄清问题）。 | | ✓（绿色勾号） | 上一轮已顺利完成。 | | ✕（红色叉号） | 上一轮至少出现了一个工具错误。 | | 灰色 | 空闲 / 未运行 agent。 | 将鼠标悬停在状态图标上，可查看当前正在运行的工具（例如 *"Edit Models/Foo.swift"*、*"Bash: ls"*），以及（针对 Claude / Codex）agent 上次回复的单行摘要。 ### 支持的 Agent | Agent | 命令 | 备注 | |---|---|---| | **Claude Code** | `claude` | 完整状态 + 轮次摘要 + 工具详情。 | | **OpenCode** | `opencode` | 完整状态 + 工具详情。暂不支持摘要。 | | **Codex** | `codex` | 状态为实验性 —— 可能略微滞后。 | 如果图标未更新，请参阅下面的[故障排除](#troubleshooting)。 ## 故障排除 ### Agent 状态图标未更新 - 确保 **Settings → Shell → Shell Integration** 已启用（默认：*detect*）。 - 关闭并重新打开终端标签页。钩子会在新 shell 启动时激活，因此在您上次升级 MUX0 之前已经打开的任何 shell 都不会被接入。 - 如果您自定义了 shell 的 rc 文件（`~/.zshrc`、`~/.bashrc` 等）并禁用了 ghostty 的 shell 集成，您需要重新启用它。 ### 保存后主题或字体未更改 设置在应用前会有约 200 毫秒的防抖延迟。如果一两秒后更改仍未生效，请将该设置关闭再打开，或者退出并重新启动 MUX0。 ### 窗口模糊 / 透明度看起来不对劲 只有当 **Background Opacity** 低于 1.0 时，模糊才有可见效果。如果您想要磨砂玻璃外观，请先降低透明度，然后再提高模糊半径。 ### 首次启动时提示“MUX0 can't be opened” 这是 macOS 的 Gatekeeper 警告。前往 **System Settings → Privacy & Security**，滚动到底部，然后点击 MUX0 条目旁边的 **Open Anyway**。您只需执行一次此操作。 ### 自动更新未检测到新版本 自动更新每天最多运行一次。要强制检查，请打开 **Settings → Update** 并点击 **Check for Updates**。 ## 文档 - [设置参考](docs/settings-reference.md) — 解释了每个设置 - [Agent 钩子参考](docs/agent-hooks.md) — 状态图标是如何接入的 - [国际化](docs/i18n.md) — 支持的语言和行为 ## 许可证 MUX0 在 **Source-Available License** 下发布 —— 详见 [`LICENSE`](LICENSE)。简明解释如下： - **✅ 免费使用 MUX0，包括用于商业工作。** 个人使用、在公司使用、用于构建和交付商业产品 —— 就像您使用任何其他终端应用程序一样。您在 MUX0 中创建的任何内容都归您所有。 - **✅ 欢迎复刻以回馈贡献。** 在 GitHub 上复刻，进行您的更改，然后提交 PR。我们感激您的贡献。 - **🚫 不允许重新分发 MUX0 本身。** 禁止转售、禁止将 MUX0 捆绑到您交付的产品中、禁止将其作为服务托管、禁止维护作为并行发行版的竞争性复刻。发布源代码是为了透明度和贡献，而不是作为产品重新使用。 这不是 OSI 批准的开源许可证。如需重新分发、捆绑、作为服务托管或维护非贡献性的复刻，请联系版权持有者。 **贡献。** 通过提交拉取请求，您同意 [LICENSE § 9](LICENSE) 中的条款 —— 简而言之，您授予项目使用您的贡献并将其作为 MUX0 一部分重新许可的权限。

标签：AI Agent状态监控, AI编程助手, Claude Code, Codex, Ghostty, Git分支显示, Metal渲染, OpenCode, Sparkle, 中英双语, 主题定制, 分屏终端, 命令行界面, 多合一终端, 威胁情报, 工作区管理, 开发者工具, 效率工具, 标签页管理, 窗口管理, 终端仿真器, 终端复用器, 终端工具, 自动更新, 透明度调节