pi-shield

Pi extension that shields your files and system from accidental destructive operations

Packages

Package details

extension

Install pi-shield from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-shield
Package
pi-shield
Version
1.0.2
Published
May 15, 2026
Downloads
not available
Author
ruru516
License
MIT
Types
extension
Size
25.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 Shield

A Pi extension that asks for confirmation before risky file, git, bash, and privilege operations.

Install

pi install npm:pi-shield

UI

Shield status lives in the editor border.

Settings panel:

Permission confirmation:

Commands

/shield
/shield on
/shield off
/shield default on
/shield default off
/shield notifications on
/shield notifications off
  • /shield opens the settings panel.
  • /shield on/off changes the current session only.
  • /shield default on/off changes the default for future sessions.
  • /shield notifications on/off toggles macOS notifications globally.

Shortcut

Ctrl+Shift+S

Toggles the shield for the current session.

Protects

  • write and edit tool calls
  • destructive bash commands like rm, mv, delete
  • risky git / GitHub CLI commands
  • privilege commands like sudo and chmod 777

Notifications

macOS notifications are shown for permission requests and agent completion.

They can be disabled from /shield or with:

/shield notifications off

Config

~/.pi/agent/pi-shield.json

License

MIT