Loop Graph 代理循环实时图
侧面板实时画出项目的代理循环:步骤、路径、子代理与命令。
示意。实际效果取决于 Mod、终端和运行环境。
安装
/plugin marketplace add ziedgithub/claude-code-mods
/plugin install loop-graph@zied-mods
/reload-plugins在 Claude Code 会话里逐行执行这些命令。
claude plugin marketplace add ziedgithub/claude-code-mods
claude plugin install loop-graph@zied-mods然后在会话里执行 /reload-plugins,或开一个新会话。
请帮我安装 Claude Code Mod「Loop Graph 代理循环实时图」(https://github.com/ziedgithub/claude-code-mods)。安装前先阅读仓库 README 的 Security 和 Requirements 部分,告诉我它会读写哪些内容、运行什么命令、是否联网,以及对 Claude Code 版本、系统和终端的要求。确认没有问题后,运行 claude plugin marketplace add ziedgithub/claude-code-mods 和 claude plugin install loop-graph@zied-mods 完成安装,最后提醒我在会话里执行 /reload-plugins。把这段话发给 Claude Code,它会先读原作者说明再安装。
git clone https://github.com/ziedgithub/claude-code-mods
cd claude-code-mods
claude --plugin-dir ./loop-graph克隆仓库后用 --plugin-dir 在本地会话中试用。
它会碰什么
据原作者说明,收录时核对;可用 claude plugin validate 自行检查。
读取
有读取项目 .claude/loop-graph/map.json、工具调用与标记命令、子代理状态和上下文用量。
写入文件
有setup 经同意后写入地图、标记脚本并改循环指令;面板尺寸存插件目录。
运行命令
未说明联网
未说明介绍
Loop Graph 是 Claude Code 的 function hooks Mod:当 Claude 执行你项目里的多步循环(规划、派子代理、测试、评审、回退修复的 skill 或命令)时,在聊天旁的面板里实时画出:
- Now:正在进行的步骤、已用时间与 token,每个工作中的代理及其模型与上下文占用,运行超过几秒的 shell 命令,以及等待你批准或回答的状态。
- 路径:本次运行走过的每一步(时长、token 与结果,如
3 tests failed、VERDICT: FIX),经过的弧线和剩余步骤。 - 地图:整个循环的所有步骤与弧线,走过多次的标次数,地图外的跳转标红。
- 提醒:测试失败或评审不通过、代理上下文超 80%/90% 或被压缩、代理 5 分钟无输出、重复回到同一步、超出轮数上限、缓存变冷等。
面板只在循环自己报告位置时移动:每一步开头要运行一条标记命令 node .claude/loop-graph/loop-step.mjs <step>,不会凭命令猜测。插件自带 /loop-graph:setup skill:读懂你的循环、展示草稿,经你同意后写入 .claude/loop-graph/map.json、复制标记脚本、在每步指令开头加一行标记,并可添加命令许可。之后用 /loop-graph 打开面板,reload 重读地图,reset 清空运行。
需要 Claude Code 2.1.296 或更新版本,且每个项目要先做一次 setup。README 没有专门的安全说明,权限按 README 与源码整理;评分为资料校准,未经本站实测。预览为示意。
适合谁
- 用多步 skill/命令跑规划-实现-测试-评审循环的人
- 想实时看到子代理在做什么、卡在哪的人
运行要求
- Claude Code ≥ 2.1.296
- 每个项目需先运行 /loop-graph:setup 生成地图与标记。
- 循环每步开头要运行 node 标记命令,需要 Node.js。