pi-file-protection
Pi extension that confirms before delete/edit operations - protects files from accidental changes
Package details
Install pi-file-protection from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-file-protection- Package
pi-file-protection- Version
1.2.1- Published
- Mar 11, 2026
- Downloads
- 56/mo · 9/wk
- Author
- ruru516
- License
- MIT
- Types
- extension
- Size
- 7.4 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
Pi Agent File Protection / Pi Agent 文件保护
A Pi extension that protects your files and system from accidental destructive operations.
一个保护您的文件和系统免受意外破坏操作的 Pi 扩展。
Features / 功能
Git & GitHub CLI Protection / Git 与 GitHub CLI 保护
Prompts for confirmation before executing blacklisted git commands, and before executing any gh commands.
执行黑名单中的 git 命令前会要求确认,并且执行任何 gh 命令前也会要求确认。
Delete Protection / 删除保护
Prompts for confirmation before running destructive commands like rm, rmdir, unlink, mv, or any command containing "delete" (e.g., find -delete, kubectl delete).
执行破坏性命令(如 rm、rmdir、unlink、mv)或包含 "delete" 的命令(如 find -delete、kubectl delete)前会要求确认。
Edit Protection / 编辑保护
Prompts for confirmation before:
- Using
writeoredittools - Running bash commands like
truncate,sed -i, or output redirection (>,>>)
在以下操作前会要求确认:
- 使用
write或edit工具 - 运行 bash 命令如
truncate、sed -i或输出重定向(>、>>)
Privilege Protection / 权限保护
Prompts for confirmation before:
- Running
sudocommands (elevated privileges) - Setting dangerous permissions with
chmod/chown 777
在以下操作前会要求确认:
- 运行
sudo命令(提升权限) - 使用
chmod/chown 777设置危险权限
Installation / 安装
推荐方式 (Recommended):
pi install npm:pi-file-protection
从源码安装 (From source):
pi install git:github.com/rUrU516/pi-file-protection
Update / 更新
To get the latest features and protections:
获取最新功能和保护:
pi update
Usage / 使用
Once installed, the extension automatically activates and will prompt you for confirmation before executing any protected operations.
安装后,扩展会自动激活,并在执行任何受保护的操作前提示您确认。
License / 许可证
MIT