Install

Requirements

• Pi, verified against @earendil-works/pi-coding-agent 0.85.1.
• Node.js 22.19 or newer if you build from source.

Try it without installing

From your project directory:

pi -e /path/to/pi-prompt-profiles

-e loads the extension for the current run only. Your Pi settings are not modified.

Install it

From npm:

pi install npm:pi-prompt-profiles

From a local checkout:

pi install /path/to/pi-prompt-profiles

This writes the package to your Pi settings. To keep it project-local:

pi install -l /path/to/pi-prompt-profiles

What it reads

The extension reads Markdown from two locations and never touches anything else:

<agentDir>/system-prompts/
├── config.json
└── profiles/
    └── base.md

<projectDir>/.pi/system-prompts/
├── config.json
└── profiles/
    └── local.md

<agentDir> is what Pi resolves for getAgentDir(), normally ~/.pi/agent. Project files are read only when the project is trusted.

Uninstall

pi remove /path/to/pi-prompt-profiles

Uninstalling does not delete your profiles or config. Delete the system-prompts/ folders yourself if you want to remove the data.

Next

Write your first profile and see it applied to Pi.