工具概览
agent-guard 是面向编码智能体的 shell 钩子,在破坏性命令运行之前将其拦截。它被描述为一个约 60 行的 shell 钩子,用于阻止无法撤销的命令。它在智能体提出的每条 shell 命令执行前运行,以退出码 2 表示拒绝,并把原因写入 stderr;智能体 CLI 会把 stderr 反馈回循环中,使智能体不再重试,而是把该命令交给人处理。它可配合 Claude Code 的 PreToolUse 钩子使用,也适用于任何在工具调用前运行 shell 钩子并遵循其退出码的智能体 CLI。它需要 bash、grep -E 和 python3。
被拦截的命令包括 git reset --hard、rm -rf、git clean -f/-x、git checkout .、git filter-branch、对 main/master/production 的强制推送、DROP TABLE、TRUNCATE、FLUSHALL、aws delete-* / terminate-*、kubectl delete、terraform destroy、docker … prune、chmod 777、curl … | sh,以及对 /dev/sd* 的原始写入。规则集中在脚本顶部的一个数组中,以 label@@regex 成对形式存放。用户可以编辑规则并添加测试用例,包括新模式不应拦截的无害命令。
该项目声明,它能阻止一个自信的智能体以明文提出不可逆命令,但无法阻止任何刻意规避它的行为,例如混淆的命令、通过 eval 执行的 base64 载荷、shell 脚本或别名。它采用故障关闭策略:如果无法从钩子载荷中读出命令,就会拦截。它不能替代服务端分支保护、最小权限凭据和备份。采用 MIT 许可证。
定价
目录尚未确认完整价格档位,请到官网查看当前额度、限制及计费方式。
访问官网价格与限制可能变化,请以官网为准,并确认币种、付款周期、最低席位数和用量上限。
应用场景
- 团队用 agent-guard 阻止编码智能体运行无法撤销的命令。
- 团队用 agent-guard 拒绝提出的 shell 命令,并把原因返回给智能体循环。
- 团队用 agent-guard 阻止对 main、master 或 production 分支的强制推送。
- 团队用 agent-guard 阻止 DROP TABLE、TRUNCATE 和 FLUSHALL 等破坏性数据库命令。
- 团队用 agent-guard 阻止 aws delete/terminate、kubectl delete 和 terraform destroy 等云与基础设施破坏性命令。
- 团队用 agent-guard 添加自定义 label@@regex 规则,并用无害命令测试它们。
- 团队用 agent-guard 在无法读取钩子载荷时故障关闭。
- 团队将 agent-guard 与服务端分支保护、最小权限凭据和备份配合使用。
功能特性
在代理执行前检查命令
拦截破坏性 Shell 命令
拒绝时返回退出码 2
通过标准错误输出拦截原因
将拒绝原因反馈给代理
可在浏览器中测试命令
规则在本地运行且无需依赖
用户评论
还没有评论,来分享你的使用体验吧