跳到正文
claudemods

Agent Tree:用方框树查看的 Claude Code 子代理面板

在侧边栏用方框画出子代理,同时显示主会话、顾问和会话日志。

权限

  • 拦截工具调用能看到 Claude 发起的每一次工具调用(tool.call / tool.check),并可以阻止或修改它。
  • 读取你的提示词可以看到你输入的内容和对话记录(prompt.* / session.append / session.messages)。
  • 修改界面在 Claude Code 界面中绘制内容:横条、面板、状态文字、弹出通知(ui.render / $.ui.*)。
  • 添加命令/工具注册新的斜杠命令或工具,供你或 Claude 调用($.command.register / $.tool.register)。
实测版本
v2.1.310
最近实测
需要
Claude Code ≥ 2.1.287
显示位置
面板、状态栏

在 Claude Code 中安装:

/plugin install agent-tree --marketplace MikeGT4/agent-tree
全部安装方式 ↓

这个插件能做什么?

Agent Tree 是 Mike Pollow, Digitalroots(MikeGT4)制作的社区插件。它是一个 Claude Code 子代理面板,在侧边栏把你的子代理画成一棵方框树。最上面是主会话,显示模型、思考强度、上下文用量和轮次。下面每个子代理一个方框,显示类型、模型、描述、最近使用的工具、状态行和时间条。最后一个方框表示回到主会话的路径,并显示已返回的答复数量。

树的旁边是顾问栏,显示是否配置了顾问模型、被咨询了多少次(来自主会话还是子代理)以及时间。最下面的会话日志列出各轮对话、代理的启动与结束、顾问调用以及你自己的选择。代理很多时,面板会改用紧凑的行;包含大量代理的工作流会折叠成一个方框。

这个面板同时也是控制面。点击代理的类型可以查看它的任务、最近的工具和最新答复,并可以停止它。你还可以为新的子代理或某个运行中的代理选择模型系列。只有这些情况下,插件才会改变 Claude Code 的行为。状态栏还会得到一条简短摘要,例如 Sub-agents [1/1] · $0.00。作者在 Claude Code 2.1.296 以及 2.1.307 至 2.1.310 上测试过。

演示

录屏中,我们在小型演示项目里启动加载了该插件的 Claude Code,并运行 /agent-tree 打开面板:主会话空闲,还没有子代理,会话日志为空。然后让 Claude 用子代理读取 src/login.js 并用一句话描述。面板切换为“工作中”,日志出现“Round 1”一行,一个 general-purpose 子代理显示为运行中,主会话处于“等待子代理”,上下文数字逐渐更新。代理完成后,它的答复会计入“回到主会话”方框。

安装

使用安装区块中的任意一种方式;它们都直接从作者自己的插件市场安装。之后运行 /agent-tree 打开面板。

$ install agent-tree

需要 Claude Code ≥ 2.1.287

从作者自己的 marketplace 安装: MikeGT4/agent-tree

  1. 1.在 Claude Code 中一行安装

    /plugin install agent-tree --marketplace MikeGT4/agent-tree

    粘贴到正在运行的会话中(v2.1.275+)。Claude Code 会先询问是否添加该插件市场。

  2. 2.从终端安装

    claude plugin marketplace add MikeGT4/agent-tree
    claude plugin install agent-tree@agent-tree

    然后在所有已打开的会话中运行 /reload-plugins。

  3. 3.免安装试用

    git clone https://github.com/MikeGT4/agent-tree
    claude --plugin-dir ./agent-tree

    仅在当前会话中加载该插件,不会写入你的设置。

工作原理

插件用一个状态原子保存整棵树,并监听代理事件:agent.spawn 添加节点,tool.call 统计工具,turn.step 记录模型、强度和顾问使用,turn.complete 把代理标记为完成、失败或已停止。ui.render 根据该状态绘制面板。一个 250 毫秒的定时器只在有代理运行时驱动旋转动画。会拦截工具调用的是停止功能,代码来自 hooks/register.tsx:

if (stoppingIds.has(agentId)) {
  if (e.tool !== HANDBACK) {
    const current = await read($, tree)
    return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
  }

只有你要求停止的代理会受影响。来自会话的文本(任务、答复、工具标签)在绘制前会先清理:去掉终端转义和控制字符,看起来像令牌、密码或 KEY=value 的字符串会被替换成 •••。工具标签只显示文件名、程序名或主机名,不显示完整命令。

自定义

/config 提供五个选项:停靠面板的宽度(默认 90 列,范围 40 到 140)、树保留多少个子代理(默认 30)、启动时打开(默认关闭)、动画(旋转和流动效果,默认开启)以及语言(auto、de、en)。你手动拖动的宽度优先。面板内的快捷键:m 打开模型选择,0 到 4 选择,x 关闭,s 在详情中停止,ctrl+x tab 聚焦面板。

权限与安全

我们读过插件可以执行的每一个文件:hooks/hooks.json、register.tsx、model.ts、view.tsx、words.ts、类型声明、测试、README 和 PRIVACY.md。没有 package.json、安装脚本、二进制文件或打包代码。唯一的非文本文件是一个 PNG 图标。

  • 网络、进程、文件、守护进程、密钥: 都没有。我们没有发现网络调用、shell 命令、文件写入、环境变量或凭据访问,Claude Code 退出后也没有任何东西继续运行。没有代理忙碌时,定时器会停止。
  • 读取内容: 代理列表和子代理消息(用于详情视图)、你的 language 和 advisorModel 设置,以及上下文和花费数据。
  • 遥测: 没有。
  • 拦截型钩子: agent.spawn 会为没有指定模型的新子代理加上你选的模型;turn.step 把运行中代理的下一步切换到你选的模型,或在你按下停止时换成一条简短报告;tool.call 拒绝已停止代理之后的工具调用。三者都只在你在面板中点击之后才起作用,与 README 和 PRIVACY.md 的说明一致。停止报告是一条合成的助手消息,包含一个带随机 id 的 SubagentHandback 工具调用。
  • 提示词注入: 没有发现。插件不向提示词添加文字,也没有隐藏的 Unicode。
  • 许可证: MIT,带 LICENSE 文件。

claude plugin validate 没有报告错误或警告;它提示插件目录对 hooks 模块有自己的规则,validate 并不检查这些规则。作者的 63 个测试在 Claude Code 2.1.310 上全部通过。

拦截工具调用
能看到 Claude 发起的每一次工具调用(tool.call / tool.check),并可以阻止或修改它。
读取你的提示词
可以看到你输入的内容和对话记录(prompt.* / session.append / session.messages)。
修改界面
在 Claude Code 界面中绘制内容:横条、面板、状态文字、弹出通知(ui.render / $.ui.*)。
添加命令/工具
注册新的斜杠命令或工具,供你或 Claude 调用($.command.register / $.tool.register)。

兼容性与故障排除

已在 macOS 上使用 Claude Code 2.1.310 检查(validate、测试和录屏)。它需要 mod 接口。如果面板没有出现:

  • claude --version 为 2.1.287 或更高版本。
  • 你运行了 /agent-tree;面板默认不会打开。成功时命令会输出 “Agent Tree opened”。
  • 终端足够宽:低于 84 列时顾问栏会叠在树的上方,面板宽度低于 40 列时布局会很拥挤。
  • 插件加载之前已启动的代理,会在你打开面板时从代理列表中补上。
  • 普通会话中面板没有内容:没有子代理时它会显示 “no sub-agents yet”。

常见问题

Agent Tree 会发送数据或发起网络请求吗?
不会。代码中没有任何网络调用,作者的 PRIVACY.md 也说明没有数据离开本机。它只在内存中保存当前会话的树,不写任何文件。
能在面板里停止正在运行的子代理吗?
可以。点击代理的类型打开详情,再按“停止”(或按 s 键)。该代理之后的工具调用会被拒绝,它的下一步会返回一条简短的“已被用户停止”报告。
能更换子代理的模型吗?
可以。“模型”按钮为新的子代理设置模型系列(Haiku、Sonnet、Opus 或 Fable),运行中代理方框上的按钮则切换它接下来的步骤。调用本身已指定的模型不会被改动。
面板会一直打开吗?
默认不会。运行 /agent-tree 打开,/agent-tree stop 关闭,/agent-tree clear 重新开始整棵树。开启“启动时打开”设置后,每次会话都会自动打开。
标签是英文吗?
默认跟随语言设置,在德语和英语之间选择。“语言”选项可以强制使用 de 或 en。日志中的时间以 24 小时制显示。
Agent Radar 在 Claude Code 中运行精选

Agent Radar

在提示词上方为每个运行中的子代理显示一行实时状态:用时、工具数和当前动作,另有 /radar 面板。

  • 输入框上方
  • 面板
  • 弹出通知
  • 拦截工具调用
  • 读取你的提示词
  • 修改界面
  • 添加命令/工具

已在 v2.1.291 实测

Agent Profiler 在 Claude Code 中运行精选

Agent Profiler

看清 Claude Code 会话的时间花在哪:模型等待、工具和子代理,状态栏实时显示,并可导出 OTLP 追踪。

  • 状态栏
  • 面板
  • 弹出通知
  • 写入文件
  • 网络访问
  • 拦截工具调用
  • 修改界面
  • 添加命令/工具

已在 v2.1.303 实测

更多 面板与仪表盘、计时、待办与站会。