prompt-tool
v1.1.0
Published
Manage and quickly switch between prompts in VSCode
Maintainers
Readme
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(orCmd+Alt+Pon 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(orCmd+Alt+Pon 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
- Clone this repository
- Run
npm installto install dependencies - Run
npm run compileto build the extension - Press
F5to open a new Extension Development Host window - Test the extension in the new window
From VSIX (when published)
- Download the
.vsixfile - Open VSCode
- Go to Extensions view (
Ctrl+Shift+X) - Click the "..." menu and select "Install from VSIX..."
- Select the downloaded
.vsixfile
Usage
Quick Start
- Press
Ctrl+Alt+P(orCmd+Alt+Pon Mac) to open the prompt picker - If no prompts exist, you'll be prompted to create your first one
- 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
- Select text in your editor
- Run
Prompt Manager: Add New Prompt - 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.jsonin your workspaceglobal: 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 fileDevelopment
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 watchTesting
- Press
F5to open Extension Development Host - Test the extension functionality
- Check the Debug Console for any errors
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- 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
