Organize, rate, and share prompts with your team. Never lose a great prompt again. Centralized prompt management with search, tags, and ratings.
Organize, rate, and share prompts with your team. Never lose a great prompt again. Centralized prompt management with search, tags, and ratings.
Organize, rate, and share prompts with your team. Never lose a great prompt again.
Author: Shadow Rose
License: MIT
Quality: quality-verified
You've discovered a prompt that works perfectly. Your teammate found one that saves hours. Someone else rated a prompt 5 stars. Where do you keep all of this knowledge?
Random text files? Scattered notes? Lost in chat history?
PromptVault solves this:
One vault. Entire team. All the prompts that matter.
# Add your first prompt
python prompt_vault.py add "Helpful Assistant" \
--text "You are a helpful, friendly assistant." \
--category system
# Search for prompts
python prompt_vault.py search "assistant"
# Rate a prompt
python prompt_vault.py rate abc123def456 --rating 5 --notes "Perfect for customer support"
# Generate HTML browse interface
python prompt_browse.py -o browse.html
# Export for team sharing
python prompt_sync.py export prompt_vault.json -o team_export.json
Categories:
Tags: Add as many as you want. Search by any tag.
Metadata: Author, model compatibility, creation date, last modified
Rate prompts 1-5 stars with notes:
python prompt_vault.py rate abc123def456 --rating 5 --notes "Works great with GPT-4"
Search by minimum rating:
python prompt_vault.py search --min-rating 4
Know which prompts are team favorites.
Every time you use a prompt, track it:
python prompt_vault.py get abc123def456 --use
See most-used prompts:
python prompt_vault.py stats
Data-driven prompt management.
Search by:
# Find all code review prompts rated 4+
python prompt_vault.py search "code review" --category task --min-rating 4
# Find all prompts by Alice
python prompt_vault.py search --author Alice
# Find prompts tagged "python" or "coding"
python prompt_vault.py search --tags python,coding
Export prompts:
# Export high-rated prompts for team
python prompt_sync.py export prompt_vault.json -o team_best.json --min-rating 4
# Export specific categories
python prompt_sync.py export prompt_vault.json -o system_prompts.json --categories system
Import prompts:
# Import with skip duplicates (default)
python prompt_sync.py import my_vault.json --from team_best.json
# Import and replace duplicates
python prompt_sync.py import my_vault.json --from team_best.json --strategy replace
# Import and merge (combine tags, keep highest rating)
python prompt_sync.py import my_vault.json --from team_best.json --strategy merge
Compare vaults:
python prompt_sync.py diff my_vault.json coworker_vault.json
Generate a static HTML page for easy browsing:
python prompt_browse.py -o browse.html
Features:
Perfect for teams who want a simple, visual way to explore prompts.
Every update is logged:
python prompt_vault.py update abc123def456 --text "Updated prompt text"
The vault automatically tracks:
Works great with Git, Dropbox, Google Drive, network shares.
# Add system prompts
python prompt_vault.py add "Code Reviewer" \
--text "You are an expert code reviewer..." \
--category system \
--tags "coding,reviews" \
--author "Alice"
python prompt_vault.py add "Technical Writer" \
--text "You are a technical writer who explains concepts clearly..." \
--category system \
--tags "writing,documentation" \
--author "Bob"
# List all system prompts
python prompt_vault.py list --category system
# Use a prompt for a task
python prompt_vault.py get abc123def456 --use
# After testing, rate it
python prompt_vault.py rate abc123def456 --rating 5 --notes "Perfect results with GPT-4"
# Check usage stats
python prompt_vault.py stats
Output:
=== Vault Statistics ===
Total prompts: 15
Average rating: 4.2/5
By category:
system: 5
task: 8
template: 2
Most used:
Code Reviewer: 23 times
Bug Fixer: 18 times
Documentation Writer: 12 times
Person A (Curator):
# Create initial vault with best prompts
python prompt_vault.py add "Sprint Planner" --text "..." --category task --rating 5
python prompt_vault.py add "Bug Analyzer" --text "..." --category task --rating 5
# Export for team
python prompt_sync.py export my_vault.json -o team_prompts.json --min-rating 4
Person B (Team Member):
# Import team prompts
python prompt_sync.py import my_vault.json --from team_prompts.json
# Add own prompts
python prompt_vault.py add "My Custom Prompt" --text "..." --category task
# Generate browse interface
python prompt_browse.py -o browse.html
Person C (Contributor):
# Import team prompts
python prompt_sync.py import my_vault.json --from team_prompts.json --strategy merge
# Rate and improve
python prompt_vault.py rate abc123def456 --rating 4 --notes "Works but could be more specific"
python prompt_vault.py update abc123def456 --text "Improved version..."
# Export updated version
python prompt_sync.py export my_vault.json -o my_improvements.json
# Script to find and use a prompt
#!/bin/bash
PROMPT_ID="abc123def456"
# Get prompt text
TEXT=$(python prompt_vault.py get $PROMPT_ID --use | grep -A 999 "text:" | tail -n +2)
# Use with AI API
curl -X POST https://api.example.com/chat \
-d "{\"prompt\": \"$TEXT\"}"
prompt_vault.py add "NAME" --text "PROMPT TEXT" [OPTIONS]
Options:
--category CATEGORY system, task, template, snippet, chain
--tags TAGS Comma-separated tags
--author AUTHOR Prompt author
--notes NOTES Usage notes
--models MODELS Compatible models
--rating RATING Initial rating (1-5)
prompt_vault.py search [QUERY] [OPTIONS]
Options:
--category CATEGORY Filter by category
--tags TAGS Filter by tags (any match)
--author AUTHOR Filter by author
--min-rating N Minimum rating
-v, --verbose Show full details
prompt_vault.py get PROMPT_ID [OPTIONS]
Options:
-v, --verbose Show full details including changelog
--use Increment usage counter
prompt_vault.py rate PROMPT_ID --rating N [OPTIONS]
Options:
--rating N Rating (1-5, required)
--notes NOTES Rating notes
prompt_vault.py update PROMPT_ID [OPTIONS]
Options:
--name NAME New name
--text TEXT New text
--category CATEGORY New category
--tags TAGS New tags
--notes NOTES New notes
prompt_vault.py delete PROMPT_ID [--confirm]
prompt_vault.py list [OPTIONS]
Options:
--category CATEGORY Filter by category
-v, --verbose Show full details
prompt_vault.py stats
prompt_vault.py categories
prompt_vault.py tags
prompt_sync.py export VAULT.json -o OUTPUT.json [OPTIONS]
Options:
--categories CATS Comma-separated categories to include
--min-rating N Minimum rating to include
--include-private Include notes and changelog
prompt_sync.py import VAULT.json --from IMPORT.json [OPTIONS]
Options:
--strategy STRATEGY skip (default), replace, or merge
--update-existing Update existing prompts with newer data
prompt_sync.py diff VAULT1.json VAULT2.json [-v]
prompt_browse.py -o OUTPUT.html [OPTIONS]
Options:
--vault VAULT.json Source vault (default: prompt_vault.json)
--title TITLE Page title
See config_example.json for reference constants and example values
# Vault location
VAULT_PATH = './prompt_vault.json'
# Categories
DEFAULT_CATEGORIES = ['system', 'task', 'template', 'snippet', 'chain']
# Team settings
TEAM_SETTINGS = {
'default_author': 'Team',
'require_category': True,
}
# Custom categories
CUSTOM_CATEGORIES = ['code_review', 'creative_writing']
See config_example.json for all available options.
prompt-vault/
├── prompt_vault.py # Main library engine
├── prompt_browse.py # HTML interface generator
├── prompt_sync.py # Export/import for sharing
├── config_example.json # Configuration template
├── prompt_vault.json # Your vault (created on first use)
├── README.md # This file
├── LIMITATIONS.md # What this tool doesn't do
└── LICENSE # MIT License
Python 3.7+ (standard library only — no external dependencies)
Bad: "Prompt 1", "Test prompt"
Good: "Bug Analyzer - Python", "Sprint Planning Assistant"
Agree on team tags: coding, writing, analysis, not code/coding/dev
Don't rate on creation. Use it first, then rate based on actual results.
When rating, note which model, what task, and results:
Rating 5/5: Perfect with GPT-4 for code reviews. Catches edge cases consistently.
Share team exports weekly or monthly. Keep everyone aligned.
Use --use flag when grabbing prompts. Data shows what actually works.
Generate HTML browse interface for team members who don't use CLI.
# Commit vault changes
git add prompt_vault.json
git commit -m "Added new code review prompts"
git push
# Team pulls changes
git pull
# Auto-export high-rated prompts nightly
0 2 * * * python prompt_sync.py export my_vault.json -o /shared/team_best.json --min-rating 4
# Daily backup to cloud
0 1 * * * cp prompt_vault.json ~/Dropbox/backups/prompt_vault_$(date +\%Y\%m\%d).json
MIT License means you can:
MIT License — see LICENSE file for details.
Free for personal and commercial use.
Shadow Rose
Q: Can multiple people use the same vault file?
A: Yes! Store on a network drive, Dropbox, or Git repo. The format is merge-friendly.
Q: What if two people edit at the same time?
A: Use Git for merging, or export/import to combine changes safely.
Q: Does this work with any AI model?
A: Yes! Store prompts for any model (GPT, Claude, Gemini, local models, etc.)
Q: Can I migrate from my current prompt system?
A: Yes. Write a quick script to convert your format to PromptVault JSON, then import.
Q: How do I backup my vault?
A: It's just a JSON file. Copy it anywhere. Enable auto-backup in config.
Q: Can I have multiple vaults?
A: Yes! Use --vault flag to specify different vault files.
Q: Is there a GUI?
A: No built-in GUI, but the HTML browse interface works like one. Or build your own on top of the CLI.
Q: Can I search by partial match?
A: Yes, search is substring-based by default.
Never lose a great prompt again. Start building your vault today:
python prompt_vault.py add "Your First Prompt" --text "Make it great" --category task
This software is provided "AS IS", without warranty of any kind, express or implied.
USE AT YOUR OWN RISK.
By downloading, installing, or using this software, you acknowledge that you have read this disclaimer and agree to use the software entirely at your own risk.
DATA DISCLAIMER: This software processes and stores data locally on your system. The author(s) are not responsible for data loss, corruption, or unauthorized access resulting from software bugs, system failures, or user error. Always maintain independent backups of important data. This software does not transmit data externally unless explicitly configured by the user.
| 🐛 Bug Reports | TheShadowyRose@proton.me |
| ☕ Ko-fi | ko-fi.com/theshadowrose |
| 🛒 Gumroad | shadowyrose.gumroad.com |
| @TheShadowyRose | |
| 🐙 GitHub | github.com/TheShadowRose |
| 🧠 PromptBase | promptbase.com/profile/shadowrose |
Built with OpenClaw — thank you for making this possible.
🛠️ Need something custom? Custom OpenClaw agents & skills starting at $500. If you can describe it, I can build it. → Hire me on Fiverr
ZIP package — ready to use