prompt-vault

name	prompt-vault
description	Save, search, tag, and manage reusable AI prompts via the `pv` CLI. Local SQLite-backed prompt library with version history, tag filtering, and JSON export/import.

Prompt Vault

Local-first prompt manager. Use when asked to save a prompt, find a saved prompt, list prompts by tag, or export/import the prompt library.

Prerequisites

• pv CLI installed: npm install -g BunsDev/prompt-vault
• Data stored at ~/.prompt-vault.db (SQLite)

Commands

Save a prompt

pv add "prompt text here" --tags tag1,tag2

• Tags are comma-separated, no spaces
• Returns the prompt ID

Search prompts

pv search "keyword"

• Substring match on prompt text

List prompts

pv list              # all prompts, newest first
pv list --tag code   # filter by tag

Export library

pv export            # JSON to stdout
pv export > prompts.json

Workflow Patterns

Save a prompt the user liked

When the user says "save that prompt" or "remember this prompt":

1. Identify the prompt text from conversation context
2. Ask for tags if not obvious (or infer from context)
3. pv add "<text>" --tags <tags>

Find a prompt for reuse

When the user says "find my prompt about X" or "use that refactor prompt":

1. pv search "X" to find matches
2. Present the best match
3. Use it in the current task

Suggest tags

Common useful tags: system-prompt, code-review, refactor, summary, debug, explain, test, docs, creative, agent, tool-use

Notes

• Prompt text with quotes: escape inner quotes or use single quotes around the CLI arg
• The DB is local-only — no sync. Use pv export to back up.
• Search is basic substring matching (LIKE %query%)