🔓 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