pi-prompt-enhancer

A fork of @danchamorro/pi-prompt-enhancer for the pi coding agent, extending it with a configurable dedicated model for prompt enhancement.

Instead of always using whatever model is currently active in your session, you can pin a specific model (e.g. a free GitHub Copilot model) that is used exclusively for enhancement — regardless of what you have selected for regular coding work.

---

Features

• Ctrl+Shift+E — enhance the current editor text in-place
• Ctrl+Shift+Z — restore original prompt (undo enhancement)
• /enhance <prompt> — enhance inline text, place result in editor
• /enhance-model — interactive picker to set the enhancement model from your configured providers
• Status bar indicator showing the currently pinned model (✨ gpt-5-mini)
• Global and project-level config, with project taking precedence
• Merge-safe config writes — other keys in the JSON are preserved

---

Prerequisites

• pi coding agent installed and running
• At least one AI provider configured in pi (run /model inside pi to verify)

---

Installation

Option A — extensions entry in settings.json (recommended)

Clone the repo somewhere on your machine:

git clone https://github.com/DxVapor/pi-prompt-enhancer.git ~/projects/pi-prompt-enhancer

Add it to ~/.pi/agent/settings.json:

{
  "extensions": [
    "~/projects/pi-prompt-enhancer"
  ]
}

Then run /reload inside pi.

Option B — copy into the extensions directory

cp ~/projects/pi-prompt-enhancer/{index.ts,clean.ts} ~/.pi/agent/extensions/prompt-enhancer/

Note: If you previously had "npm:@danchamorro/pi-prompt-enhancer" in your packages list, remove it first to avoid duplicate command registration.

---

Configuration

Interactive (recommended)

Run /enhance-model inside pi. Two sequential prompts appear:

1. Scope — global (all projects) or project-local
2. Model — every model that has auth configured in pi's registry

There is a "↩ Use active session model" option at the top to clear a previously pinned model.

The command writes to the JSON config file automatically (creating directories as needed).

Manual JSON

Global — applies to all projects:

~/.pi/agent/extensions/prompt-enhancer.json

Project-local — overrides global for one project:

<project-root>/.pi/extensions/prompt-enhancer.json

Both files use the same format:

{ "model": "gpt-5-mini" }

model must match the id of a model in pi's registry. Run /model inside pi to browse available IDs.

Model resolution order

Priority	Source
1	model in project config (.pi/extensions/prompt-enhancer.json)
2	model in global config (~/.pi/agent/extensions/prompt-enhancer.json)
3	Active session model — original upstream behaviour

Tip: When the same model ID exists under multiple providers (e.g. gpt-5-mini appears under both azure-openai-responses and github-copilot), the extension picks the first one that has auth configured — so you always get a working model rather than a silent failure.

---

Usage

Key / Command	Action
Ctrl+Shift+E	Enhance editor text in-place
Ctrl+Shift+Z	Restore original (undo)
/enhance <prompt>	Enhance inline text, place result in editor
/enhance-model	Pick or reset the dedicated enhancement model

The status bar shows ✨ <model-id> when a model is pinned. While enhancement is running it briefly shows ✨ Enhancing (<model-name>)....

---

How it differs from the upstream

	@danchamorro/pi-prompt-enhancer	This fork
Model used	Active session model	Config file → fallback to active model
Config	—	prompt-enhancer.json (global + project)
Model picker	—	/enhance-model command
Status bar	—	✨ <model-id> when pinned
Duplicate provider fix	—	Searches authed models first

The system prompt, enhancement logic, clean(), and all shortcuts are unchanged from upstream.

---

Contributing

Contributions are welcome. Please open an issue before submitting a large PR so we can discuss the approach first.

1. Fork the repo and create a branch: git checkout -b feat/your-feature
2. Make your changes
3. Commit using Conventional Commits: feat(config): add support for per-session overrides
4. Open a pull request against main

For bug reports, please include:

• pi version (pi --version)
• Contents of your prompt-enhancer.json (redact any keys)
• The error notification or behaviour you observed

---

License

MIT — see LICENSE.

Original extension by Daniel Chamorro.