🔓 pi-yolo-bypass

Dynamic full-permission bypass toggle for pi-permission-system.

When you need to temporarily grant the agent free rein — bypassing all deny rules, including dangerous commands like rm -rf, sudo, and external directory access restrictions — toggle bypass mode with a single command or keyboard shortcut. When you're done, restore your original granular policy file instantly.

How it works

Instead of modifying the permission system's internal state, this extension atomically replaces the pi-permissions.jsonc policy file with an all-allow version. The original is backed up to pi-permissions.jsonc.yolo-bak. pi-permission-system's file-stamp cache detects the change on the next permission check — no /reload needed.

Session-scoped: Bypass is automatically restored on session shutdown (quit, /new, /resume, /fork), so it never leaks into other pi sessions. If pi crashes while bypass is active, the next session_start detects the orphaned backup and auto-recovers.

Action	What happens
/yolo-bypass on	Backup → write all-allow policy → 🔓 ACTIVE
/yolo-bypass off	Remove bypass → restore backup → 🔒 INACTIVE
/yolo-bypass (toggle)	Switches between on/off
/yolo-bypass status	Shows state, policy path, and backup status
/yolo-bypass force-off	Emergency recovery if backup is lost
Ctrl+Shift+Y	Quick toggle from anywhere

Installation

pi install npm:pi-yolo-bypass

Or from git:

pi install git:github.com/skyscribe/pi-yolo-bypass

Requirements

• pi-permission-system must be installed and configured
• A pi-permissions.jsonc policy file must exist in pi's agent directory

Recovery

If something goes wrong, your original policy is always at pi-permissions.jsonc.yolo-bak. Rename it back manually and run /reload:

mv ~/.pi/agent/pi-permissions.jsonc.yolo-bak ~/.pi/agent/pi-permissions.jsonc

Or use the built-in force-restore: /yolo-bypass force-off

License

MIT