Prompt Templates

Prompt templates are Markdown files that expand into complete prompts when invoked with /name syntax.

Locations

LocationScope
~/.pi/agent/prompts/*.mdGlobal
.pi/prompts/*.mdProject
Package directoriesPackage
--prompt-template CLI flagRuntime

Structure

The filename becomes the command name. review.md becomes /review.

---
description: Review code for best practices
---

Review the following code for best practices and potential issues:

$@

Arguments

SyntaxDescription
$1, $2Positional arguments
$@ or $ARGUMENTSAll arguments
${@:N}Arguments starting at position N
${@:N:L}L arguments starting at position N

Discovery

Template discovery in prompts/ is non-recursive. Use settings or package manifests for subdirectories.