📝

CCMux 是一个开源 TUI 工具：后台守护进程扫描 tmux 中运行的 Claude Code、Codex、Cursor、Gemini CLI 等 AI Agent，用交互式终端界面统一展示 idle/working/waiting 状态，支持实时预览、就地操作、通知审批、ccmux invoke 脚本调用，内置 MCP Server 实现 Agent 互调度。

CCMux：给所有 AI Coding Agent 装一块总控制台

本文转载自小红书（无糖AI），已补充 GitHub 元数据验证与 README 机制分析。

原文观点

当你同时开着 5 个 Claude Code、3 个 Codex、还有几个 Cursor Agent 时，CCMux 就像给所有 AI Agent 装上了一块「总控制台」。

很多重度 AI Coding 用户都会遇到一个问题：Agent 越开越多，却忘了哪个终端在干什么，哪个正在等你点击确认。

CCMux 自动扫描 tmux 中运行的 Claude Code、Codex、Cursor、Gemini CLI 等 Agent，用一个终端界面统一展示它们的状态：谁还在工作、谁已经完成、谁正在等待你的操作，一眼就能看清。

它不仅能「看」，还能「管」：

直接创建新的 Agent
恢复历史会话、重启任务
ccmux invoke 让脚本自动调用 AI Agent 完成一次任务
内置 MCP Server，让一个 Agent 可以调度另一个 Agent，实现真正的多智能体协作

📊 GitHub 数据验证

项目	数据
仓库	epilande/ccmux
Stars	113 ⭐
Forks	10
语言	TypeScript（Bun）
License	MIT
创建时间	2026-07-06（约 1 个月）
最近更新	2026-08-06（当天有推送，活跃）
Topics	ai-agents, claude-code, codex, cursor, gemini-cli, tmux, tui, opentui, session-manager

⚠️ 项目较新（113⭐），但作者迭代活跃（当天还在推送），且依赖注入机制（agent hooks）设计成熟。

🔧 工作机制

核心设计：不改变你启动/运行 Agent 的方式——ccmux 通过后台守护进程发现 tmux pane 里已经在跑的 Agent，因此”只要你在 tmux 里跑受支持的 Agent，它就能工作”。

后台守护进程：监控会话活动，通过 SSE 实时推送状态变化（无轮询、无刷新）
内置支持：Claude Code、Codex、Cursor、OpenCode、Pi、Antigravity、Copilot、Gemini CLI + 自定义 Agent 定义（config）
Agent hooks：ccmux setup 安装 hooks 实现权威会话匹配（不装也能用，装了更准）

✨ 核心能力

🎯 实时会话状态：每个 Agent 标记为 idle / working / waiting（权限/计划审批/提问），需要你时立刻标记
👁️ 实时预览：分屏查看选中会话的 pane 内容
⚡ Act in Place：Tab 进预览直接审批、回答、输入，按键直达 pane
🔔 可操作通知：从桌面通知直接 approve / deny / reply
📊 Sidebar 模式：常驻会话侧栏 dock 在工作 pane 旁
🔍 模糊搜索：按项目/分支/路径匹配会话，或搜最近 prompt、捕获的 pane 内容、实时转写
🌿 Git & PR 感知：分支/worktree 检测、PR 打开状态 + 实时 CI/评审状态
📝 Diff Review：按 d 用 hunk 直接在 pane 里审工作树 diff
🤖 后台 Agent & Subagents：Claude Code 后台 Agent 也有独立行；运行中的 subagents 显示为 agents 并可实时查看列表
🔁 会话控制：TUI 里 spawn / kill / restart；ccmux invoke 脚本化单次 Agent 调用
⌨️ 键盘优先、鼠标友好：Vim 键 + 数字跳转 + 点击切换 + 右键菜单

🚀 快速开始

# 安装（Homebrew）
brew install epilande/tap/ccmux
ccmux setup        # 安装 agent hooks（推荐）

# 使用
ccmux              # 启动交互式 picker

绑定 tmux 快捷键随时弹出（~/.tmux.conf）：

1 2	# Prefix + C-p: 居中弹窗打开 ccmux bind-key C-p display-popup -E -w 80% -h 75% "ccmux"

🧭 在 Agent 控制台生态中的定位

CCMux 属于「AI 编程 Agent 统一控制台」生态的tmux 会话管理路线：

工具	定位	差异
CCMux（本实体）	tmux 内 Agent 会话总控制台	不改变工作流、发现式接入、SSE 实时状态、MCP Server 调度
[[agentsview-session-manager]]	会话历史管理与成本分析	事后分析（SQLite 聚合 20+ 工具历史）vs CCMux 实时控制
[[paseo]]	多 Agent orchestrator	本地调度/切换/交接 vs CCMux tmux 原生发现
[[codux]]	原生 AI 终端	聚合多 AI CLI 的工作空间 vs CCMux 叠加在 tmux 上

CCMux 的最大特点：不迁移工作流——你继续在 tmux 里开 Agent，它来给你一块总控制台。

原文链接

https://xhslink.cn/o/pOmRKDsD5L

CCMux：给所有 AI Coding Agent 装一块总控制台，tmux 里一眼看清谁在等你