dev/docs/prompts.md

Custom prompts

Save frequently used prompts as Markdown files and reuse them quickly from the slash menu.

• Location: Put files in $CODE_HOME/prompts/ (defaults to ~/.code/prompts/; Code also reads legacy ~/.codex/prompts/).
• File type: Only Markdown files with the .md extension are recognized.
• Name: The filename without the .md extension becomes the slash entry. For a file named my-prompt.md, type /my-prompt.
• Content: The file contents are sent as your message when you select the item in the slash popup and press Enter.
• Arguments: Local prompts support placeholders in their content:
  • $1..$9 expand to the first nine positional arguments typed after the slash name
  • $ARGUMENTS expands to all arguments joined by a single space
  • $$ is preserved literally
  • Quoted args: Wrap a single argument in double quotes to include spaces, e.g. /review "docs/My File.md".
• How to use:
  • Start a new session (Code loads custom prompts on session start).
  • In the composer, type / to open the slash popup and begin typing your prompt name.
  • Use Up/Down to select it. Press Enter to submit its contents, or Tab to autocomplete the name.
• Notes:
  • Files with names that collide with built‑in commands (e.g. /init) are ignored and won’t appear.
  • New or changed files are discovered on session start. If you add a new prompt while Code is running, start a new session to pick it up.