Prompt Bank

Managing, Reusing and Sharing Prompts Right From Your IDE.
Enhance your development workflow by saving, searching, and inserting AI prompts instanly.

A powerful VS Code extension to save and manage your frequent prompts for AI assistants, code templates, and development workflows.

🚀 Key Features

• Save Prompts Instantly: Select any text and save it as a prompt with a title, description, and category via the context menu or Command Palette.
• Save from Selection: Right-click selected text in the editor and choose "Save Selection as Prompt" to quickly save with prefilled content.
• Tree View: Browse and manage all your prompts in a hierarchical tree view organized by categories. Click any prompt to insert it instantly.
• Modern Editor: Create and edit prompts in a clean, two-column webview editor with dynamic category dropdown and inline category creation.
• Share & Import: Share individual prompts or entire collections via public links. Import prompts and collections from others with automatic conflict resolution.
• Multi-Device Sync: Synchronize prompts across multiple devices with smart conflict detection, deletion tracking, and restore capabilities. Never lose work when editing the same prompt on different machines.
• Drag & Drop: Reorder categories and prompts with intuitive drag & drop interface. Move prompts between categories seamlessly.
• Category Management: Create, rename, and organize prompts into categories. Categories are automatically managed and sorted.
• Powerful Search: Find prompts quickly with integrated search that scans titles, content, descriptions, and categories.
• Context Menus: Right-click on any prompt or category for all actions: Edit, Copy, Delete, Share, and Rename Category.
• Inline Actions: Use the convenient copy icon in the tree view for quick prompt copying.
• Authentication: Secure Google OAuth integration for sharing and sync features.
• Persistence: All data persists across VS Code sessions with atomic file operations.

🎯 Quick Start

1. Save a Prompt:

   • Option 1: Select text in the editor, right-click, and choose "Save Selection as Prompt" from the context menu.
   • Option 2: Use Command Palette (Ctrl+Shift+P) → "Prompt Bank: Save Prompt" to save from clipboard.
   • Fill in the details in the prompt editor and save.

2. Copy a Prompt:

   • From the Sidebar: Find your prompt in the "Prompt Bank" tree and click the copy icon.
   • From Command Palette: Use "Prompt Bank: List All Prompts" to search and select a prompt to copy.

3. Manage Prompts:

   • Right-click any item in the tree view to see all management options.

4. Share Prompts:

   • Single Prompt: Right-click any prompt and select "Share" to get a public link.
   • Collection: Use Command Palette (Ctrl+Shift+P) → "Prompt Bank: Share Collection" to share entire categories or the complete prompt bank.

5. Import Prompts:

   • Command Palette → "Prompt Bank: Import Prompt" → paste share link.
   • Automatic conflict resolution handles duplicate titles and categories.

6. Sync Across Devices (NEW):

   • First Time Setup: Sign in with Google OAuth (same account used for sharing).
   • Three-Way Merge: Intelligent sync algorithm compares local, remote, and last-synced states to detect changes on all devices.
   • Manual Sync: Command Palette → "Prompt Bank: Sync Prompts" to synchronize with cloud.
   • Auto-Sync: Enable automatic synchronization in settings (promptBank.sync.autoSync) for seamless background syncing.
   • View Status: Check sync state with "Prompt Bank: View Sync Status" to see user, device name, and last sync time.
   • Unlimited Devices: Sync across as many devices as you need - desktop, laptop, work machine, etc.
   • Smart Conflict Resolution:
     • Modify-Modify: When the same prompt is edited on multiple devices, both versions are preserved with device names and timestamps for manual review.
     • Delete-Modify: When a prompt is deleted on one device but modified on another, the modified version always wins (prevents accidental data loss).
   • Deletion Support:
     • Deleted prompts are tracked and synced across all devices with tombstones to prevent re-downloading.
     • Soft-deleted prompts are retained for 30 days before permanent removal.
     • Restore Capability: Recover accidentally deleted prompts within the retention period using Edge Functions.
   • Device Tracking: Each change tracks which device made it, helping you understand prompt history.
   • Fresh Start: Use "Prompt Bank: Clear Sync State" to reset sync metadata if needed.

🔧 Commands & Keybindings

📁 Storage

Prompts are stored both locally and in the cloud:

Local Storage (atomic file operations):

• Project-Specific: .vscode/prompt-bank/prompts.json (for prompts tied to the current workspace)
• Sync State: .vscode/prompt-bank/sync-state.json (tracks sync metadata, deletion tombstones per device)
• Global: ~/.vscode-prompt-bank/prompts.json (as a fallback for prompts available everywhere)
• Data Format: JSON with metadata including creation/modification dates and usage tracking

Cloud Storage (when sync enabled):

• Backend: Supabase with PostgreSQL and Row Level Security
• Privacy: Data isolated per user account - no sharing between users unless explicitly shared
• Deletion: Soft-delete with 30-day retention period before automatic permanent removal
• Garbage Collection: Server-side automatic cleanup runs daily

🔐 Authentication

Sharing and sync features require Google OAuth authentication via Supabase Auth:

• First Time: When you first share or sync, you'll be redirected to Google to authorize the extension
• Secure: Modern JWKS-based JWT verification with ECC (P-256) asymmetric keys for enhanced security
• Automatic: Once authorized, sharing and sync work seamlessly without further prompts
• Account Linking: Same Google account is used for both sharing and sync features
• Token Verification: All API requests are verified using public-key cryptography with zero-downtime key rotation support
• Offline Grace Period: Tokens cached locally with 5-minute grace period for offline scenarios

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on how to:

• Set up the development environment and run the test suite to ensure everything works as expected
• Submit bug reports and feature requests
• Create pull requests with automated CI/CD validation

📋 Changelog

See CHANGELOG.md for a detailed history of changes and new features.