prompt-tool

Prompt Manager - VSCode Extension

A powerful VSCode extension for managing and quickly switching between text prompts. Perfect for developers who frequently use AI assistants, code templates, or standardized text snippets.

Features

• 🚀 Quick Access: Use Ctrl+Alt+P (or Cmd+Alt+P on Mac) to instantly open the prompt picker
• 📝 Prompt Management: Add, edit, and delete prompts with ease
• 🏷️ Tagging System: Organize prompts with tags for better categorization
• 💾 Flexible Storage: Store prompts in workspace (.vscode folder) or globally
• 🔍 Smart Search: Search prompts by name, description, or content
• ✨ Quick Insert: Insert prompts directly into your active editor
• 📋 Clipboard Integration: Right-click to copy any prompt to clipboard
• ⚡ Quick Add from Selection: Right-click on selected text to quickly create a new prompt

Usage

Quick Access

• Press Ctrl+Alt+P (or Cmd+Alt+P on Mac) to open the prompt picker
• Select a prompt to insert it at your cursor position
• Use the management options to add, edit, or delete prompts

Context Menu Features

• Copy Prompt to Clipboard: Right-click in any editor and select "Copy Prompt to Clipboard" to choose a prompt and copy it to your clipboard
• Add Prompt from Selection: Select any text in the editor, right-click, and choose "Add Prompt from Selection" to quickly create a new prompt from the selected content

Keyboard Shortcuts

• Ctrl+Alt+P / Cmd+Alt+P: Open prompt picker

Installation

From Source

1. Clone this repository
2. Run npm install to install dependencies
3. Run npm run compile to build the extension
4. Press F5 to open a new Extension Development Host window
5. Test the extension in the new window

From VSIX (when published)

1. Download the .vsix file
2. Open VSCode
3. Go to Extensions view (Ctrl+Shift+X)
4. Click the "..." menu and select "Install from VSIX..."
5. Select the downloaded .vsix file

Usage

Quick Start

1. Press Ctrl+Alt+P (or Cmd+Alt+P on Mac) to open the prompt picker
2. If no prompts exist, you'll be prompted to create your first one
3. Select a prompt to insert it at your cursor position

Managing Prompts

Adding a New Prompt

• Use the command palette: Prompt Manager: Add New Prompt
• Or select "Add New Prompt" from the quick picker
• Fill in the prompt details:
  • Name: A descriptive name for your prompt
  • Description: Optional description explaining the prompt's purpose
  • Content: The actual text content of the prompt
  • Tags: Optional comma-separated tags for organization

Editing Prompts

• Use the command palette: Prompt Manager: Edit Prompt
• Or select "Edit Prompt" from the quick picker
• Choose the prompt to edit and modify its properties

Deleting Prompts

• Use the command palette: Prompt Manager: Delete Prompt
• Or select "Delete Prompt" from the quick picker
• Confirm the deletion when prompted

Creating Prompts from Selected Text

1. Select text in your editor
2. Run Prompt Manager: Add New Prompt
3. The selected text will be used as the prompt content

Configuration

Access settings via File > Preferences > Settings and search for "Prompt Manager":

promptManager.storageLocation

• Default: workspace
• Options: workspace, global
• Description: Where to store prompts
  • workspace: Stores in .vscode/prompts.json in your workspace
  • global: Stores in VSCode's global storage

promptManager.promptsFile

• Default: prompts.json
• Description: Name of the file to store prompts

Commands

Command	Description	Default Keybinding	Context Menu
promptManager.showQuickPick	Show Prompt Quick Pick	Ctrl+Alt+P / Cmd+Alt+P	-
promptManager.addPrompt	Add New Prompt	-	-
promptManager.editPrompt	Edit Prompt	-	-
promptManager.deletePrompt	Delete Prompt	-	-
promptManager.copyPromptToClipboard	Copy Prompt to Clipboard	-	Right-click in editor
promptManager.addPromptFromSelection	Add Prompt from Selection	-	Right-click on selected text

Sample Prompts

The extension comes with example prompts in the examples/ folder. You can use these as inspiration or copy them to your prompt storage:

• Code Review Request: Template for requesting code reviews
• Bug Report: Structured bug report template
• Function Documentation: JSDoc template for functions
• AI Code Assistant: General prompt for AI coding assistance
• Git Commit Message: Conventional commit message template

File Structure

prompt-manager/
├── src/
│   ├── extension.ts          # Main extension file
│   ├── promptStorage.ts      # Prompt storage management
│   ├── promptQuickPick.ts    # Quick pick interface
│   └── types.ts             # TypeScript type definitions
├── examples/
│   └── sample-prompts.json  # Example prompts
├── package.json             # Extension manifest
└── README.md               # This file

Development

Prerequisites

• Node.js (v16 or higher)
• VSCode (v1.74.0 or higher)

Setup

# Clone the repository
git clone <repository-url>
cd prompt-manager

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch for changes during development
npm run watch

Testing

1. Press F5 to open Extension Development Host
2. Test the extension functionality
3. Check the Debug Console for any errors

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

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

Changelog

0.0.1

• Initial release
• Basic prompt management functionality
• Quick pick interface
• Workspace and global storage options
• Tag support
• Sample prompts included