pi-warden

给 Pi 代理加护栏，写文件守规则，假完成和死循环当场抓出

pi-warden 是给 Pi 编码代理加装的护栏扩展，核心思路是“引导而非打断”。它在代理每次写文件时自动执行项目规则，只拦截真正难以撤销的高风险操作——官方在真实会话中测得每 1000 次调用仅约 3 次触发硬拦截，尽量不干扰正常流程。除了写操作约束，它还能识别代理未经验证就宣称“完成了”的虚假结论，以及陷入重复循环卡死的情况，并会裁剪过长的工具输出，降低上下文占用。项目基于 pi-typesafe 构建，用 TypeScript 编写，属于自动化工作流分类，适合已经在用 Pi 做代码生成或批量修改、又担心代理乱写文件或假报成功的团队。它把规则检查前置到写入环节，让代理在既定边界内自主工作，而不是频繁弹窗要求确认。

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 144

维护状态活跃

是否开源是

定价模式 free

项目数据

分类自动化工作流

开发团队DevMortimer

所属国家

官网地址

GitHubhttps://github.com/DevMortimer/pi-warden

定价模式free

价格说明开源免费，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-guardrails,guardrails,pi-extension,pi-package,typesafe

GitHub 星标★ 144

30天Star增速

HF 下载量

上线时间2026-09-16 00:00:00

最近更新2026-09-25 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-26

浏览次数0

使用教程

核心亮点

写操作实时执行项目规则，把约束前置到落盘前而非事后检查
硬拦截率极低，实测每千次调用约 3 次，正常流程几乎无感
能识别未验证的“已完成”声明和卡死循环，并裁剪工具输出节省上下文

不足之处

仅适配 Pi 生态，脱离 Pi 的代理框架无法直接复用
项目处于早期，规则配置方式与文档完善度有待观察

适用场景

用 Pi 代理批量重构代码时，防止它违反项目命名或目录规范
让代理长时间自主跑任务，避免它假报完成或陷入重复循环
在大型仓库中控制代理工具输出长度，减少上下文被日志淹没

替代项目

OpenHands、Aider、SWE-agent

项目介绍

pi-warden 是一个自动化工作流领域的开源项目，官方简介：Guardrails for Pi that steer instead of interrupt: enforces your project rules on every write, holds only hard-to-undo actions (3 per 1,000 calls, measured on real sessions), catches unverified "done" claims and stuck loops, and trims tool output. Built on pi-typesafe.。项目使用 TypeScript 开发，在 GitHub 上获得 144 星标。

上一篇：rssh

下一篇：obsei