pi-readonly-mode

Strict read-only mode extension for pi: blocks edit/write and destructive bash commands, toggled with /readonly or --readonly.

Package details

extension

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

$ pi install npm:pi-readonly-mode

Pi manifest JSON

{
  "extensions": [
    "./extensions/readonly-mode.ts"
  ]
}

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

Strict read-only mode extension for pi.

While active it:

Limits the active tool set to read, bash, grep, find, ls, question.
Silently blocks edit and write tool calls.
Blocks bash commands matching destructive patterns (rm, mv, cp, sudo, git writes, package installs, redirects, editors, etc.).
Injects hidden guidance telling the model it may only inspect and analyze.
Shows a small READONLY status indicator.
Persists across sessions and resumes.

pi install npm:pi-readonly-mode

Or try it for a single invocation without saving it:

pi -e npm:pi-readonly-mode

The mode is persisted in the session, so resuming a session restores its state.

MIT