@pi-minimal/plan-mode

Minimal plan mode for pi: /plan toggles a read-only instruction in the system prompt.

Packages

Package details

extension

Install @pi-minimal/plan-mode from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@pi-minimal/plan-mode

Package: @pi-minimal/plan-mode
Version: 1.0.2
Published: Oct 30, 2026
Downloads: 657/mo · 268/wk
Author: evihex
License: MIT
Types: extension
Size: 6 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@pi-minimal/plan-mode

/plan toggles plan mode. When on, the system prompt tells the agent to stay read-only and output a plan. Nothing is blocked: the agent is trusted to obey.

Install

pi install npm:@pi-minimal/plan-mode

Settings

Put settings in ~/.pi/agent/settings.json (global) or .pi/settings.json (project), under "pi-minimal"."plan-mode". Merge the keys; do not overwrite the file. Settings are read at session start (use /reload).

Key	Type	Default	Meaning
`keyboardShortcut`	string (key id)	`ctrl+alt+p`	Shortcut that toggles plan mode. No pi default uses it. Some terminals need Alt/Option set as Meta, and multiplexers such as tmux may drop modifiers. If it does not work, pick another key.

{ "pi-minimal": { "plan-mode": { "keyboardShortcut": "ctrl+alt+o" } } }