Claude Code、Codex跑完任务不错过Muxy如何实时追踪10大AI编码代理【免费下载链接】muxyLightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty项目地址: https://gitcode.com/gh_mirrors/muxy1/muxyMuxy 是一款基于 SwiftUI 与 libghostty 构建的轻量 Mac 终端它内置了 AI 编码代理实时追踪能力在 Muxy 终端里运行 Claude Code、Codex 等 10 余款 AI 代理时Muxy 会自动安装生命周期 Hook、监听前台进程把每个代理工作中 / 等待输入 / 已完成的状态实时呈现在分屏状态点、工作树徽标和桌面通知里任务一跑完立刻提醒你。Muxy 是什么为 AI 代理而生的轻量终端Muxy 主打轻内存占用低、启动快同时提供分屏、垂直标签页、Git worktree、快速终端等现代终端能力。更关键的是它把自己变成了一个AI 代理的控制台—— 每个终端分屏pane独立追踪一个 AI 代理的生命周期 代理完成回合turn时推送应用内 Toast 与 macOS 原生桌面通知 状态聚合到 worktree 和项目层级Agents Focused 侧边栏一眼看到哪个项目有代理在忙 状态还会以agent.status事件开放给 Muxy 扩展生态。官方文档见docs/features/ai-notifications.md覆盖清单哪些 AI 编码代理被追踪Muxy 目前内置 11 款代理的完整集成全部在 Muxy/Services/Providers/ 目录下以Provider实现代理Provider 源码Hook 入口脚本Claude CodeClaudeCodeProvider.swiftmuxy-claude-hook.shCodexCodexProvider.swiftmuxy-codex-hook.shCursor CLICursorProvider.swiftmuxy-cursor-hook.shGitHub CopilotCopilotProvider.swiftmuxy-copilot-hook.shAntigravity CLIAntigravityProvider.swiftmuxy-antigravity-hook.shGrokGrokProvider.swiftmuxy-grok-hook.shDroidDroidProvider.swiftmuxy-droid-hook.shKiro CLIKiroProvider.swiftmuxy-kiro-hook.shOpenCodeOpenCodeProvider.swiftopencode-muxy-plugin.jsPiPiProvider.swiftmuxy-pi-extension.tsXalXalProvider.swiftmuxy-xal-plugin.ts其中 Claude Code、Codex、Cursor、Copilot 走各家官方 Hook 机制如 Claude Code 的~/.claude/settings.json中的 Stop / Notification / PermissionRequest 等事件OpenCode、Pi、Xal 这类自带插件系统的工具则通过轻量插件转发事件最终统一交给同一个桥接程序。双重追踪机制Hook 为主进程探测兜底Muxy 的追踪不是猜而是两套独立信号源互为备份Hook 信号永远是权威。第一层Hook 事件驱动精确信号每个 Provider 安装时Muxy 会在对应工具的配置里写入自己的 Hook例如 Claude Code 集成会把 muxy-claude-hook.sh 挂到 7 个生命周期事件上。这些脚本极薄——只做一件事exec同目录下编译好的muxy-hook桥接二进制事件就通过本地 Unix Socket~/Library/Application Support/Muxy/muxy.sock以 v3 协议的 JSON 行送达 Muxy{v:3,kind:agent_event,provider:claude_hook,phase:finished,title:Claude Code,body:Done}phase只有三种working干活中、waiting等你的确认/输入、finished回合结束。协议细节、去重与重试策略都在 docs/features/ai-notifications.md 的 Protocol (v3) 一节。第二层前台进程检测兜底信号万一 Hook 缺失或配置坏了怎么办Muxy 的 AIAgentDetector.swift 会持续检查每个分屏的前台进程名把它和 11 款代理的可执行文件名claude、codex、cursor…做规范化比对认出这里跑着一个代理。细节上非常克制避免误判检测发现工作中的代理离开前台后Muxy 给4 秒宽限期等 Hook 的finished事件窗口内 Hook 永远胜出不会提前置闲waiting状态的代理进程还活着不能用同一标准——宽限拉长到30 秒且每轮结束先确认进程是否真的消亡防止把真正在等你输入的代理误判为结束实现见 AgentStatusStore.swift 中的detectionLossGrace与waitingDetectionLossGrace。三态模型working / waiting / finished 如何呈现状态收敛在 AgentStatusStore.swift 中按working waiting idle的优先级向 worktree 和项目聚合working代理正在执行侧边栏与工作树显示忙碌状态点waiting代理停下等你——例如 Claude Code 弹出权限请求此时你会收到需要关注通知⚪finished → idle回合完成触发完成徽标 Toast 桌面通知Agents Focused 侧边栏随即移除该项。会话结束代理进程退出与回合结束是两回事进程退出会立即结束该 pane 的代理会话但已完成回合的徽标和通知仍保留方便回头查看。在哪里开启与测试Settings → Notifications 一键排障无需手写任何配置。打开Settings → Notifications界面代码见 NotificationSettingsView.swift每个 Provider 一行自带三件套开关按工具启停追踪状态点健康引擎实时汇报——已安装 / 需要修复 / 冲突conflict表示发现了非 Muxy 的同名 HookMuxy 绝不会覆盖你的第三方配置Test 按钮通过真实 Socket 发一条测试事件验证桥接二进制 → Socket → 服务端 → 应答整条链路Refresh按钮则重新铺设 Hook 文件并再次校验。健康引擎是声明式验证 修复启动时、工具可用时、配置文件被外部修改时FSEvents 监听~/.claude、~/.codex等都会自动重新校验并在漂移时原位修复且带写回哈希与限速不会自我触发死循环。相关实现可看 HookInstaller.swift 与 HookHealthStore.swift。常见问题收不到通知怎么办按顺序排查详见 docs/user-guide/troubleshooting.md 到 Settings → Notifications 看对应 Provider 的状态点点Refresh重新铺设再点Test确认链路 OpenCode / Xal 的插件在启动时加载——Muxy 修复文件后需重启正在运行的会话Copilot CLI 修复后同样重启 CLI 才能加载新配置 Hook 投递失败会记录到~/Library/Application Support/Muxy/hooks.logSocket 是否存活可检查muxy.sock是否存在 SSH 远程跑的代理不在本机进程表里检测层看不到它此时完全依赖 Hook 或 pane 关闭来结束会话。小结Muxy 用一个很聪明的架构解决了AI 代理跑完没人知道的痛点Hook 提供精确事件、进程检测提供兜底、四态状态机负责聚合、健康引擎负责自愈把 Claude Code、Codex 等 10 余款 AI 编码代理的生命周期统一收敛成你看得懂的状态点和通知。装好 Muxy把代理跑在它的终端里剩下的就不用管了——任务一完成提醒自然会到。【免费下载链接】muxyLightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty项目地址: https://gitcode.com/gh_mirrors/muxy1/muxy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考