@tombell/pi-plan

Read-only planning mode for safe investigation before editing

Packages

Package details

extension

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

npm report
$ pi install npm:@tombell/pi-plan
Package
@tombell/pi-plan
Version
0.0.4
Published
May 31, 2026
Downloads
546/mo · 24/wk
Author
tombell
License
BSD-3-Clause
Types
extension
Size
8.7 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

@tombell/pi-plan

Read-only planning mode for safe investigation before making changes.

Features

  • Adds a /plan command and Ctrl+Alt+P shortcut.
  • Optional auto-start via --plan flag.
  • Restricts available tools to a safe, read-only subset:
    • read
    • grep
    • find
    • ls
    • bash (safe command subset)
  • Blocks edit, write, and unsafe shell commands while enabled.
  • Forces planning-only responses through a persistent prompt.
  • Persists mode state in session history across restarts.

Commands

  • /plan — toggle plan mode on/off

Notes

  • Bash command filtering uses isSafeReadOnlyCommand in utils.ts.

Install

  • From npm: pi install npm:@tombell/pi-plan
  • Local/quick test: pi -e path/to/pi-plan