pi-presets-plus

A Pi extension that lets you bundle a model, thinking level, tools, and system prompt into a named preset, then switch between presets with one hotkey.

Why

Pi already lets you change the model you talk to, how hard it thinks, which tools it can use, and what system prompt it follows. Each of those is its own setting, and tweaking them one at a time is fine for ad-hoc work but it gets tedious when you have a handful of working modes you keep coming back to: a fast cheap model for boilerplate, a heavy reasoning model for tricky design, a "review only" setup with no write tools and a strict prompt, a planning mode, an implementation mode.

pi-presets-plus lets you save a complete setup as a named preset and switch to it with one keystroke.

Install

pi install npm:@sherif-fanous/pi-presets-plus

Or try it without installing:

pi -e npm:@sherif-fanous/pi-presets-plus

To uninstall:

pi remove npm:@sherif-fanous/pi-presets-plus

Quick start

1. Run /presets in any Pi session to open the preset picker.
2. Press n to create a new preset, or e to edit an existing one.
3. Press F1 on any row in the editor to get help for that row.
4. Save your preset and, optionally, give it a hotkey. From then on, pressing the hotkey switches to the preset. Run /presets clear to go back to Pi's defaults.

The picker also lets you filter by name, switch the scope filter, reorder, duplicate, and delete presets. The footer always shows the keys you can press.

What's in a preset

Field	What it does
Name	A short, memorable label for the preset. Names are unique within their scope.
Scope	User presets follow you across every project. Project presets stay tied to one repo and can be shared.
Provider	The service that hosts the model (OpenAI, Anthropic, etc.). Only providers Pi knows about appear here.
Model	The specific model Pi will use when this preset is active.
Thinking	How much extra reasoning effort to ask for. Some models don't support every level; unavailable ones appear dimmed.
Tools	Either keep whatever tools are active, or pin an exact tool list to the preset.
Prompt	Extra instructions added to Pi's system prompt while the preset is active. Pi's defaults are kept either way.
Hotkey	Optional. A single key combination (like ctrl+shift+1) that switches to this preset.

Where presets live

Scope	Path
User	<agent-dir>/presets-plus/presets.json (typically ~/.pi/agent/presets-plus/presets.json)
Project	<repo>/.pi/presets-plus/presets.json

If a project preset and a user preset share a name, the project preset wins while you're working in that project.

Commands

Command	What it does
/presets	Opens the picker.
/presets clear	Clears the active preset and returns to Pi's defaults.
/presets reload	Re-reads your preset files (use after editing them by hand).
/presets status	Shows the active preset's settings compared to Pi's defaults.