pi-plan-mode

Plan mode extension for pi - read-only exploration with plan file editing

Package details

← Back
extension

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

npm repohome report
$ pi install npm:pi-plan-mode
Package
pi-plan-mode
Version
0.4.8
Published
Apr 4, 2026
Downloads
1,381/mo · 175/wk
Author
qmx
License
MIT
Types
extension
Size
9.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./plan-mode.ts"
  ]
}

Security note

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

README

pi-plan-mode

Plan mode extension for pi: a toggleable read-only mode that blocks write/edit tools.

Features

  • Simple toggle: /plan enables/disables plan mode
  • Blocks write/edit tools: When active, write and edit tools are completely blocked
  • Smart bash filtering: Safe commands allowed, mutating commands reviewed by AI
  • Git command protection: Mutating git commands (commit, push, pull, merge, etc.) are blocked
  • Status indicator: Shows "⚠️ planning" in the UI when active
  • Session persistence: Plan mode state survives session resume
  • Bash override memory: Approved commands are remembered within a session

Quick Start

  1. Enable plan mode: /plan
  2. Explore the codebase with read-only tools
  3. Disable plan mode: /plan again

Command Reference

Command What it does
/plan Toggle plan mode on/off

Safety & Restrictions

In plan mode:

  • write and edit tools are blocked
  • Safe bash commands (ls, cat, grep, find, etc.) are allowed
  • Potentially mutating bash commands are reviewed by an AI model
  • Mutating git commands are blocked
  • Commands can be approved manually and remembered for the session

Installation

npm install pi-plan-mode

Then enable it in pi via your packages/extensions configuration.

Development

  • Type-check: npm run typecheck
  • Releases: see docs/releases.md

License

MIT