pi-meta-prompt

Pi extension that rewrites a task description into an optimized prompt using a customizable meta-prompt.

Installation

pi install npm:pi-meta-prompt

Usage

/prompt <describe your task>

Example:

/prompt refactor the auth module to use JWT

The extension rewrites your description into a well-scoped prompt, displays it in the session, then asks what you'd like to do with it:

• Use in this session — loads the prompt into the editor
• Use in a new session — opens a fresh session with the prompt ready to submit
• Copy to clipboard — copies the rewritten prompt
• Edit before using — opens the prompt in the multi-line editor for review

Meta-prompts

Meta-prompts are Markdown files with YAML frontmatter that control how the rewriting is done. Use $ARGUMENTS as the placeholder for your task.

Discovery (highest priority wins):

Priority	Location
Highest	.pi/meta-prompts/*.md (project-local)
Middle	~/.pi/agent/meta-prompts/*.md (user-global)
Lowest	Bundled default (ships with this package)

Files with the same name field are deduplicated — the higher-priority source wins.

Format:

---
name: my-meta-prompt
description: A short description shown in the picker
---
The user wants to achieve the following task:

<user_task>
$ARGUMENTS
</user_task>

Write a prompt that accomplishes this task...

Return ONLY the prompt itself — no preamble, no postamble.

When only one meta-prompt is found, it is used automatically. When multiple are found, a picker appears.

Bundled meta-prompt

The default meta-prompt ships with this package and is always available as the lowest-priority fallback. Override it by creating a file named default.md in ~/.pi/agent/meta-prompts/ or .pi/meta-prompts/.