Quick Prompt – Capture Ideas & Queue Tasks While AI Works

繁體中文 | English

---

🚀 What is Quick Prompt?

When your AI agent is running, your mind doesn't stop. Quick Prompt is your in-IDE scratch pad — capture next tasks, queue ideas, store reusable snippets — without switching to Notepad++ or breaking your flow.

It combines a persistent snippet library with clipboard history tracking, so the thoughts you have while AI is working are ready to hand off the moment it finishes.

---

---

🔌 New in v0.3.0: AI Agent Integration (MCP)

Full Model Context Protocol (MCP) support is now here. Stop copy-pasting—let your AI assistant (Cursor, Copilot, Claude, etc.) manage your prompts directly with native tools.

🛡️ 4-Layer Safety Decision Tree

Every generated skill includes a built-in safety logic to ensure stable operation:

1. Layer 0: Connection Gate — Automatic check via list_prompts. If disconnected, the agent HALTS and asks for fallback.
2. Layer 1: Standard MCP Tools — Use 14 optimized tools for CRUD and versioning.
3. Layer 2: Safety Verification — Internal sanity checks across different prompt contexts.
4. Layer 3: Hard Fallback CLI — A bundled qp.bundle.js script allows the agent to edit prompts.json directly if the server is offline.

⚙️ Multi-Client Setup

One-click configuration for every major AI tool. Run: Quick Prompt: Show MCP Config to access the interactive panel.

Cursor / Antigravity	GitHub Copilot / Cline	Kiro IDE / Claude Code
Supports ${workspaceFolder} variables	Absolute path binding	Direct JSON configuration

---

✨ Key Features

🔌 AI Agent Power (New!)

• 🔌 14 MCP Tools: Complete prompt management suite for AI agents.
• 🛡️ Action Decision Tree: Ensures agents only act when connected and safe.
• 📦 CLI Fallback Bundle: Built-in insurance for offline scenarios.
• ⚙️ Interactive Config Panel: Easy setup for Cursor, Copilot, Cline, Claude, and more.

📚 Prompt Management

• 🤖 AI-Powered Titles: Automatic semantic title generation using local AI (Qwen1.5-0.5B).
• 🎯 Lightning Fast Search: Press Alt+P to search prompts, hit Enter to copy.
• 🚀 Quick Add: Right-click selected text → "Quick Add Prompt" (or press Alt+Shift+S).
• ✏️ Native Editing: Edit prompts like regular files with full VSCode support.

🕒 Version Control

• 🕒 Linear History: Automatic tracking of every save.
• 📌 Milestones: Tag stable versions or important drafts.
• ⚖️ Visual Diff: One-click comparison between history and current state.

🔒 Privacy Protection

• 🔒 Mask Prompt: Right-click any prompt → Mask Prompt. Sensitive data is replaced with tokens ([EMAIL-1], [API-KEY-1]…) in the stored content.
• 🔓 Unmask: Right-click a masked prompt → Unmask Prompt to restore the original values instantly.
• 🔑 OS-Encrypted Storage: The reverse mapping is stored in VS Code SecretStorage (OS Keychain) — persisted in encrypted form by the OS, never written to any plaintext file.

📸 Screenshots (AI Generated)

Interface Overview

The authentic unified view: Clipboard History (left) and Prompts with linear history (right)

Quick Search in Action

Unified search interface for both capture queue and clipboard history

🚀 Quick Start

First Time Setup

1. Open any project folder in VSCode
2. The extension will automatically create .vscode/prompts.json
3. Press Alt+P (Mac: Opt+P) to start using

Basic Usage

Method 1: Quick Search (Recommended) ⚡

1. Press Alt+P to open the unified search
2. Browse Prompts and Clipboard History in one place
3. Type keywords to filter
4. Press Enter to copy to clipboard
5. Paste anywhere with Ctrl+V

Method 2: Sidebar Operations 📋

1. Click the Quick Prompt icon in the Activity Bar
2. My Prompts section:
   • Click to copy
   • Right-click to move up/down
   • Inline buttons: Copy, Pin, Edit, Delete
3. Clipboard History section:
   • Click to copy
   • Pin to convert to permanent prompt
   • Inline buttons: Copy, Pin, Edit, Delete

Icon Meanings

• 🔥: Hot (used >= 10 times)
• ⭐: Frequent (used >= 5 times)
• 📝: Normal (used > 0 times)
• ⚪: Unused
• 📌: Pinned

📝 Managing Prompts

Adding Prompts

Method 1: Add from Selection (Fastest) 🚀

1. Select text in the editor
2. Right-click → "Quick Add Prompt" (or press Alt+Shift+S)
3. Done! Title is auto-generated

Method 2: Smart Add Mode ⚡

1. Click ➕ Add button in sidebar
2. In the input box:
   • Auto Mode: Paste content directly (auto-generates title)
   • Manual Mode: Use Title::Content format
3. Done!

Method 3: From Clipboard History

1. Find the item in Clipboard History
2. Click the 📌 Pin button
3. Automatically converts to permanent prompt

Editing Prompts

• Click the ✏️ Edit button to open in native editor
• Edit like a regular file
• Press Ctrl+S to save
• Full support for Undo/Redo, Auto Save, Format Document

Organizing Prompts

• Pin: Click 📌 to pin important prompts to the top
• Sort: Right-click → Move Up/Down to manually arrange
• Delete: Click 🗑️ to remove (no confirmation needed)

Using Version History (New)

1. View History: Expand any prompt in the sidebar.
2. Compare: Click on any historical version to open the Diff View.
3. Restore: Right-click a version and select Apply Version to bring it back.
4. Milestones: Tag important versions (like "V1.0 Stable") to keep them safe forever.

🔒 Privacy Protection – Usage Guide

Mask sensitive data before it reaches any AI model.

How It Works

1. Add a prompt containing sensitive data — it shows a yellow shield warning
2. Right-click → Mask Prompt
3. Sensitive values are replaced with tokens like [EMAIL-1], [API-KEY-1]; the prompt now shows a green shield
4. Copy or insert the prompt — the agent receives only tokens, never the originals
5. Right-click → Unmask Prompt to restore original values at any time

Security model: The reverse mapping (token → original value) is stored in VS Code SecretStorage (OS Keychain / Windows Credential Manager). It is never written to prompts.json or any file on disk. Unmask is machine-local — switching to a different machine means a masked prompt cannot be unmasked.

Detected Patterns (default on)

• Email addresses → [EMAIL-1]
• Phone numbers → [PHONE-1]
• API keys (AWS, GitHub, OpenAI, etc.) → [API-KEY-1]
• IP addresses → [IP-ADDRESS-1]
• Private keys / certificates → [PRIVATE-KEY-1]
• Credit card numbers → [CREDIT-CARD-1] (default: off)

Privacy Settings

• quickPrompt.privacy.enabled: Enable/disable all privacy features (default: true)
• quickPrompt.privacy.patterns.email: Mask emails (default: true)
• quickPrompt.privacy.patterns.phone: Mask phone numbers (default: true)
• quickPrompt.privacy.patterns.apiKeys: Mask API keys (default: true)
• quickPrompt.privacy.patterns.ipAddress: Mask IP addresses (default: true)
• quickPrompt.privacy.patterns.privateKey: Mask private keys (default: true)
• quickPrompt.privacy.patterns.creditCard: Mask credit card numbers (default: false)

---

📋 Clipboard History

Auto Capture

The extension automatically captures clipboard content from:

• VSCode editor: Instant capture when you copy
• External apps: Captured when you switch back to VSCode
• Background polling: Every 5 seconds (configurable)

Smart Filtering

• ✅ Deduplication (no repeated entries)
• ✅ Minimum length filter (default: 10 characters)
• ✅ Excludes pure numbers

Managing History

• View: Check recent items in sidebar
• Copy: Click to copy again
• Pin: Convert to permanent prompt
• Edit: Click edit to save as prompt and open editor
• Delete: Remove individual items
• Clear All: Click the clear button in sidebar title

⚙️ Configuration

Settings

Open VSCode Settings and search for "Quick Prompt":

Clipboard History

• quickPrompt.clipboardHistory.enabled: Enable/disable auto tracking (default: true)
• quickPrompt.clipboardHistory.maxItems: Maximum history items (default: 20)
• quickPrompt.clipboardHistory.enablePolling: Enable background polling (default: true)
• quickPrompt.clipboardHistory.pollingInterval: Polling interval in ms (default: 5000)
• quickPrompt.clipboardHistory.minLength: Minimum content length (default: 10)

AI Features

• quickPrompt.ai.enabled: Enable/disable AI-powered features (default: true)
• quickPrompt.ai.autoGenerateTitle: Automatically generate titles using AI (default: true)

File Location

• Workspace Mode: .vscode/prompts.json (independent per project)
• Fallback Mode: Uses extension directory if no workspace is open

Keyboard Shortcuts

Function	Windows/Linux	Mac
Search Prompt	Alt+P	Opt+P
Add from Selection	Alt+Shift+S	Opt+Shift+S

💡 Best Practices

1. Queue while waiting: When AI starts a long task, immediately open Quick Prompt and jot down what comes next — don't lose that thought
2. Capture on the fly: See something worth keeping? Select it and press Alt+Shift+S — title is auto-generated
3. Let clipboard history be your safety net: Copy freely; the last 20 items you copied are always retrievable (configurable via maxItems)
4. Pin your most-reached-for snippets: Turn clipboard one-offs into permanent entries with one click
5. Commit to Git: Add .vscode/prompts.json so the whole team shares the same reusable library

🎯 Use Cases

While AI is Running (Primary Use Case)

• AI is executing task N → you're already thinking about task N+1, N+2
• Quick-capture your next steps without switching to Notepad++ or breaking focus
• When the agent finishes, your queue is ready — paste and go

Reusable Snippets & Templates

• Store frequently used code patterns, review checklists, or boilerplate instructions
• Alt+P to search, Enter to copy — faster than any file or note app

Privacy-Sensitive Workflows

• Working with client data, API keys, or NDA-covered content?
• Mask sensitive values before they reach any AI model — unmask locally anytime

Team Collaboration

• Commit .vscode/prompts.json to Git to share reusable snippets with your team
• Build a shared task-queue vocabulary across the codebase

---

🤝 Recommended Companion

🗂️ VirtualTabs

Enhance your AI workflow.

Quick Prompt keeps your thoughts organized inside the IDE. Pair it with VirtualTabs to keep your workspace organized too.

• Quick Prompt: capture what you're thinking while AI works
• VirtualTabs: organize which files belong to which task — across any directory

Get VirtualTabs on VS Code Marketplace | Open VSX Registry

---

❤️ Support

If you find this extension helpful, please consider supporting the development!

📄 License

MIT License

---

Stop losing thoughts to window-switching. 🚀

Made with ❤️ for developers who think faster than their agents run