MadoHub Docs

团队协作

通过 Claude Code 团队功能监控并与团队成员协作。

MadoHub 集成了 Claude Code 的团队功能,用于实时查看团队成员的 Agent 正在做什么。

工作方式

MadoHub 会读取 ~/.claude/teams/ 中的团队配置来发现活跃的团队成员。每个在 tmux 会话中运行 Claude Code Agent 的团队成员,都可以作为一个团队面板图块显示在你的画布上。

团队检测

MadoHub 会扫描 ~/.claude/teams/ 目录,查找:

  • config.json — 团队名称、描述、主导 Agent ID 和成员列表。
  • 过滤当前有活动 tmux pane 的成员。
  • 通过 tmux list-panes 验证 pane 是否可用。

团队 pane 图块

每个团队成员都会获得一个 team pane tile,用于实时显示其终端输出。这些图块会显示:

  • 团队成员名称
  • Agent 状态指示器(working、waiting、stopped、idle、completed、failed)
  • 来自其 tmux pane 的实时终端输出

自动布局

在显示团队成员时,MadoHub 会自动排列图块:

  • 1 名成员:居中显示在画布上。
  • 2 名成员:左右并排。
  • 3 名及以上:围绕主导 Agent 以圆形方式排列,圆的半径为图块宽度加 80px。

团队 Hub

团队动态会汇总展示在 团队 Hub 中——这是右侧抽屉里的一个标签页(与 Flows、Exploration 并列)。其中包含:

  • 成员状态圆点,共六种状态:working、waiting、stopped、completed、failed、idle。
  • 任务面板,排序规则为进行中优先,其次是待处理,最后是已完成。
  • Messages 区域,显示最近 3 条团队消息,按最新在前排序。

团队消息

团队消息会从 ~/.claude/teams/{team}/inboxes/ 同步。你可以在团队 Hub 的 Messages 区域中查看它们。

团队任务

任务列表会从 ~/.claude/tasks/{team}/ 同步。可在团队 Hub 的任务面板中跟踪整个团队的共享工作项。

要求

  • 团队成员必须在 tmux 会话中运行 Claude Code。
  • ~/.claude/teams/ 目录必须包含有效的团队配置。
  • 必须已安装 tmux 且可以正常访问。

On this page