@firstpick/pi-extension-plan-mode-toggle

Toggleable planning mode extension for Pi with model switching, mandatory planning survey, and PLAN.md quality guards.

Packages

Package details

extension

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

npm report
$ pi install npm:@firstpick/pi-extension-plan-mode-toggle
Package
@firstpick/pi-extension-plan-mode-toggle
Version
0.1.7
Published
May 15, 2026
Downloads
1,000/mo · 217/wk
Author
firstpick
License
MIT
Types
extension
Size
20.1 KB
Dependencies
1 dependency · 2 peers
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

@firstpick/pi-extension-plan-mode-toggle

Plan mode workflow extension for Pi.

What it does

  • Toggle plan mode with Ctrl+Q or /plan-mode on|off|status.
  • Optionally select a dedicated planning model with /plan-model.
  • Runs a mandatory planning questionnaire before transforming prompts.
  • Forces structured PLAN.md planning output and checks for web evidence links.
  • Archives PLAN.md snapshots to ~/.pi/agent/docs/<topic>/PLAN.md.

Install

pi install npm:@firstpick/pi-extension-plan-mode-toggle

Configuration

No required configuration beyond runtime requirements.

Requirements

  • brave_search tool must be available in Pi.
  • BRAVE_SEARCH_API_KEY must be set in Pi environment.

Commands

  • /plan-mode on|off|status
  • /plan-model [select|provider/model-id]

Shortcuts

  • Ctrl+Q — toggle/arm plan mode.

Tools

None.

Example view

/plan-mode on
Plan mode enabled. Your next request will be turned into a PLAN.md first.

Ctrl+Q
Plan mode armed for the next prompt.

/plan-model select
Pick planning model:
  gpt-5-codex
  gemini-3-pro
  claude-sonnet

Plan mode is useful when the next task needs deliberate research, sequencing, or review before code changes begin.