GitHub
Mirror PromptVault prompt sources as Markdown files in a GitHub repository for audit, recovery, and review.
Mirror prompt sources as Markdown files in a GitHub repository. Every non-draft save commits an updated file; every delete commits a removal. This is useful for audit, recovery, and code review of prompt changes.
What It Does
PromptVault writes one Markdown file per prompt under the configured path. The file includes the slug, version metadata, and prompt source.
Configuration
| Field | Required | Default |
|---|---|---|
| Owner | yes | - |
| Repo | yes | - |
| Branch | yes | main |
| Path prefix | yes | prompts |
| Personal access token | yes | - |
The token must have write access to repository contents. Fine-grained tokens scoped to a single repository are recommended.
Test
Use Test after connecting to confirm the repository is accessible.
Event Handling
| Event | Behavior |
|---|---|
prompt.created | Commits the initial prompt file. |
prompt.published to live | Creates or updates the prompt file. |
prompt.published to staging | Creates or updates the prompt file. |
prompt.rolled_back | Updates the prompt file to the rolled-back source. |
prompt.deleted | Removes the prompt file when present. |
Draft-only saves are skipped.
File Format
Mirrored files are Markdown documents with the prompt slug as the heading, version metadata near the top, and the prompt source in a fenced code block.
Common Failures
| Cause | Fix |
|---|---|
| Token missing access | Reconnect with a token that can write repository contents. |
| Repository or branch not found | Recheck owner, repository, and branch spelling. |
| Branch protection | Use a writable branch or adjust branch protection. |