Configure Prompts
A prompt configuration tells PromptDeploy which file in your repository should be editable, how it should be displayed, and how changes should be deployed.
Creating a prompt config
You can configure prompts in two ways:
1. Via .promptdeploy.yml (recommended)
Add a config file to your repository root. When you connect the repo, PromptDeploy imports these definitions automatically. See the full config reference.
prompts:
- path: prompts/system.txt
name: System Prompt
deploy_mode: pr
2. Via the UI
From your connected repository page:
- Click Add prompt
- Browse the file tree and select a file
- Set a display name and description
- Choose a deploy mode (direct push or pull request)
- Optionally add metadata: provider, model, temperature
- Click Create
Prompt config fields
| Field | Required | Description |
|---|---|---|
path |
Yes | File path relative to repo root |
name |
Yes | Display name shown in the UI |
description |
No | Brief description of what the prompt does |
deploy_mode |
No | direct or pr (defaults to direct) |
provider |
No | AI provider name (e.g. anthropic, openai) |
model |
No | Model identifier (e.g. claude-sonnet-4-20250514) |
temperature |
No | Temperature setting (0.00–2.00) |
variables |
No | Array of variable definitions |
Variables
You can define template variables for a prompt. These appear in the UI as metadata but don't affect how the prompt file is stored.
variables:
- name: tone
description: Voice tone for responses
default: professional
- name: language
description: Output language
default: en
See Variables for more detail.
Editing prompts
Once configured, prompts appear on the repository page. Click any prompt to open the editor, where you can:
- Edit the prompt content directly
- See the file path and current SHA
- Save changes (which commits to GitHub)
- View edit history