
Reinwatch:监控 Claude Code 子代理用量并阻止失控的插件
来源标题:Show HN: Reinwatch – a Claude Code mod that stops runaway subagents
开发者发布 Claude Code 插件 Reinwatch,可监控子代理、协作代理和工作流代理的 token 消耗与运行时长,并在代理失控时将其停止。该插件提供状态栏、/reinwatch 面板和警告栏,支持按运行时长、token 量、重复工具调用和工具失败次数触发警告,默认阈值分别为 30 分钟、100 万 token、重复 5 次。插件已开源,采用 MIT 许可证。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
为 Claude Code 运行的 subagent、teammate 和 workflow agent 提供一个 token 与失控看门狗:按 agent 统计 token、发出警告、通知与历史记录,并提供停止某个 agent 的方法。 🇺🇸 English · 🇯🇵 日本語 Contributing · License (MIT) Claude Code 的后台任务视图会列出任务及其已用时间,可以打开任务的记录并停止任务。reinwatch 在此基础上增加了: 状态行:agents 2 running · 310k tok · 26m active,当有警告未处理时追加 · 1 warning(没有 agent 在运行时显示 reinwatch: 1 warning)。 /reinwatch 面板:每个 agent 一行(状态、名称、token 数、活跃时间、类型、模型、轮数),并带有各自的按钮,此外还显示未处理的警告、最新摘要以及 Last 30 days: 12 agents · 1.1M tok · 3h active。 输入框上方的条带:显示未处理的警告及其按钮;每轮结束后显示 3 agents · 420k tok · 14m active combined · longest: "Explore the repo" 9m active。 警告与设置 警告 触发条件 设置项 默认值 Long run 某个 agent 的活跃时间超过上限 activeMinutes 30 Tokens 某个 agent 新摄入的 token 数超过上限 tokenMillions 1 Repeat 某个 agent 以相同输入重复调用同一工具达到此次数 repeatCount 5 Failures 某个 agent 连续出现此次数的工具失败 failStreak 5 Burst 在时间窗口内启动了此数量的 agent burstCount, burstMinutes 2 分钟内 10 个 Workflow run 某次 workflow 运行启动了此数量的 agent burstCount 10 另外还有 notify(true)、openPaneOnWarning(false)和 redact(true:遮蔽描述中形似密钥的文本)。在插件的选项中设置;分钟和百万的数值可以是小数(0.5)。 token 数统计的是新 token:输入、缓存写入和输出。缓存读取不计入统计,也不参与 token 警告,仅在 Details 中显示。在终端中,警告还会进入终端自身的通知;在桌面应用中,警告仅通过你自己配置的 Notification hook 显示:参见 docs/notifications.md。 /plugin install reinwatch --marketplace sofumel/reinwatch 需要 Claude Code 2.1.300 或更高版本,在终端或桌面应用的 Code 标签页中使用。 Stop 会拒绝该 agent 新的工具调用,并在其下一次模型调用时返回一条回复,告知它汇报进展且不要继续。正在运行的工具会先执行完毕(该行显示 stopping (a tool is still running)),Allow resume 可以解除停止;停止一个 agent 不会停止它所在的 workflow。 不访问网络、不执行 shell 命令、不调用模型。只有 30 天的存储(按本地日期记录:agent 数、新 token 数、活跃毫秒数)会跨会话保留;prompt、输出和工具输入从不保存,工具输入只会变成内存中的哈希,用于识别重复。 redact 仅凭外观将形似密钥的文本替换为 [redacted]:这是防意外泄漏的护栏,并非保证。 限制 时间只在模型或工具调用处于打开状态时计数。在终端中,等待你批准的调用在提示出现时停止计数,并且在你批准后也不计入(因为没有任何东西标记你答复的时刻);在桌面应用中,等待时间也计入。 View 仅在终端中可用。View 和 Ask to stop 需要该 agent 出现在 Claude Code 的 agent 列表中,而 workflow agent 不在该列表中。 重新加载 mod 后,某一行可能显示为 "running",直到 agent 列表(每 10 秒检查一次)报告其已完成(workflow 行则直到会话结束),并且自上次摘要以来的工作不会计入 30 天总计。 贡献 环境搭建、测试和引擎规则见 CONTRIBUTING.md。 Claude Code 的后台任务画面可以查看任务列表和经过时间、显示记录、停止任务。reinwatch 在此基础上增加了以下内容。 状态行:agents 2 running · 310k tok · 26m active。有警告时会加上 · 1 warning,如果没有正在运行的 agent,则显示 reinwatch: 1 warning。 /reinwatch 列表:每个 agent 一行(状态、名称、token、实际运行时间、类型、模型、轮数)及按钮,未处理的警告,最新摘要,以及 Last 30 days: 12 agents · 1.1M tok · 3h active。 输入框上方的条带:未处理的警告及其按钮。每轮结束时显示 3 agents · 420k tok · 14m active combined · longest: "Explore the repo" 9m active。 警告与设置 警告 触发条件 设置项 默认值 Long run 单个 agent 的实际运行时间超过上限 activeMinutes 30 Tokens 单个 agent 的新增 token 超过上限 tokenMillions 1 Repeat 单个 agent 以相同输入调用同一工具达到此次数 repeatCount 5 Failures 单个 agent 连续出现此次数的工具失败 failStreak 5 Burst 在时间窗口内启动了此数量的 agent burstCount, burstMinutes 2 分钟内 10 个 Workflow run 一次 workflow 运行启动了此数量的 agent burstCount 10 此外还有 notify(true)、openPaneOnWarning(false)、redact(true:遮蔽说明中形似密钥的字符串)。设置可在插件的选项中修改,分钟和百万的值可以使用小数(0.5)。 token 数指新增 token(输入、缓存写入、输出)。缓存读取不计入统计,也不参与 token 警告,仅在 Details 中显示。在终端中,警告也会进入终端自身的通知。在桌面应用中,只有通过你自己配置的 Notification hook 才会显示(参见 docs/notifications.md)。 /plugin install reinwatch --marketplace sofumel/reinwatch 需要 Claude Code 2.1.300 或更高版本(终端,或桌面应用的 Code 标签页)。 Stop 会拒绝该 agent 新的工具调用,并在下一次模型调用时返回一条回复,告知它汇报进展且不要继续。正在运行的工具会执行完毕(该行显示 stopping (a tool is still running)),Allow resume 可以解除停止。停止一个 agent 不会停止它所在的 workflow。 不使用网络、shell 命令或模型调用。跨会话保留的只有 30 天的记录(按本地日期记录 agent 数、新增 token 数、活跃毫秒数)。prompt、输出和工具输入不会保存,工具输入只会变成内存中的哈希,用于识别重复。 redact 仅凭外观将形似密钥的字符串替换为 [redacted]。这是为了防止意外泄漏,并非保证。 限制事项 时间只在模型或工具调用处于打开状态时计数。在终端中,等待许可的调用在确认出现时停止计数,并且在你批准后也不计入(因为没有东西标记你答复的瞬间)。在桌面应用中,等待时间也计入。 View 仅在终端中可用。View 和 Ask to stop 需要该 agent 出现在 Claude Code 的 agent 列表中,而 workflow 的 agent 不在其中。 重新加载 mod 后,某一行可能保持显示 "running"。这会持续到 agent 列表(每 10 秒检查一次)报告其结束为止,workflow 的行则持续到会话结束。自上次摘要以来的工作不会计入 30 天的合计。 贡献 环境准备、测试和引擎规则见 CONTRIBUTING.md(英文)。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。