pi-persona

Custom modes for pi: debugger (read-only RCA) and more

Packages

Package details

package

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

npm report

$ pi install npm:pi-persona

Package: pi-persona
Version: 0.1.0
Published: Oct 1, 2026
Downloads: 442/mo · 27/wk
Author: shreyashp7
License: unknown
Types: package
Size: 12.5 KB
Dependencies: 0 dependencies · 2 peers

Security note

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

README

pi-persona

Custom modes for pi.

Install

# from npm (once published)
pi install npm:pi-persona

# from a local checkout
pi install ./path/to/pi-persona

Modes

Debugger mode

Read-only root-cause analysis. Pi analyzes code for a given problem and explains the root cause — it never edits or writes any file while the mode is on.

Toggle: /debugger or Ctrl+Shift+.
Status: 🔍 debug in the footer while active
edit/write are removed from the tool set; bash is restricted to read-only commands (git log, grep, running tests, …)
State persists across session resume

Typical use:

/debugger
the login endpoint returns 500 when the password contains unicode — find out why

Development

pi -e ./extensions/debugger.ts   # try the extension directly
node test/debugger.test.mjs      # runnable checks