Gately AI Prompt Manager

**🚀 Professional AI Prompt Management Extension - Organize, enhance, and deploy your prompts with AI-powered improvements** [](https://marketplace.visualstudio.com/items?itemName=gatelyAI.gately-ai-prompt-manager) [](https://code.visualstudio.com/) [](https://marketplace.visualstudio.com/items?itemName=gatelyAI.gately-ai-prompt-manager)

📋 Table of Contents

• Features
• Quick Start
• Demo
• AI Enhancement
• Core Features
• User Interface
• Usage Guide
• Keyboard Shortcuts
• Configuration
• Import/Export
• Editor Integration
• Technical Architecture
• FAQ
• Support & Feedback

✨ Features

🎯 Core Highlights

• 📝 Complete Prompt Lifecycle Management - Create, edit, delete, and organize with categories
• 🔍 Smart Search - Full-text search across titles, content, tags, and categories
• 🤖 AI-Powered Enhancement - Improve prompts and text with OpenAI integration (GPT-4, GPT-3.5)
• 📁 Hierarchical Category System - Flexible category management with unlimited levels
• 💾 Data Import/Export - JSON format supporting backup and cross-device sync
• 🔗 Multi-Editor Integration - Perfect compatibility with Cursor, VSCode and other mainstream editors
• 💬 Chat Integration - One-click send prompts to chat interface
• 📊 Usage Statistics - Automatic usage tracking with intelligent sorting recommendations
• ⚡ Performance Optimization - Debounced search, lazy loading, smooth experience

🚀 Technical Advantages

• Full TypeScript Stack - Complete type system with excellent development experience
• Event-Driven Architecture - Reactive UI updates with real-time synchronization
• Singleton Pattern Design - Efficient resource utilization and clear state management
• Factory Pattern Integration - Automatic adaptation to multiple editor environments
• Async Operation Optimization - Non-blocking UI with smooth operations

🚀 Quick Start

Installation (VS Code Marketplace)

1. Install from VSCode Marketplace

   Press Ctrl+Shift+X in VSCode to open Extensions panel
   Search for "Gately AI Prompt Manager"
   Click Install
   

2. Cursor Plugin Installation

   Due to Cursor plugin fetch delay, you can download it here: https://marketplace.visualstudio.com/items?itemName=gatelyAI.gately-ai-prompt-manager

3. Local Installation

   # After downloading the .vsix file
   code --install-extension gately-ai-prompt-manager-xxx.vsix
   

First Use

1. Activate Extension - Automatically activated after installation, find Gately AI Prompt Manager icon in Activity Bar
2. Browse Default Templates - Extension comes with pre-built templates for code review, technical documentation, problem analysis, etc.
3. Add Custom Prompts - Click the ➕ button or use shortcut Shift+P
4. Start Using - Select a prompt, automatically copied to clipboard or double-click to send to Chat

🎥 Demo

Watch our comprehensive demo showing all the powerful features of Gately AI Prompt Manager:

🎬 Watch Full Demo Video →

What you'll see in the demo:

• ✨ AI-Powered Prompt Enhancement - Transform basic prompts into professional-grade templates
• 🔍 Smart Search & Organization - Find and organize prompts instantly
• 💬 Seamless Chat Integration - One-click deployment to Cursor/VS Code chat
• 📊 Category Management - Organize prompts by projects, topics, and use cases
• 🚀 Real-time Performance - Lightning-fast operations with smooth UX

🤖 AI Enhancement

Intelligent Text Improvement

The extension now features powerful AI-driven text enhancement capabilities that can improve your prompts, code, documentation, and any text content directly within your editor.

🚀 AI Integration

• OpenAI Integration - GPT-4 and GPT-3.5 models for superior quality enhancement
• Multiple Model Support - Choose between different GPT models based on your needs
• Secure API Handling - Your API keys are stored securely and never shared

✨ Enhancement Types

• ✨ General Improvement - Enhance clarity, effectiveness, and overall structure
• 📝 Make Concise - Reduce length while preserving meaning and impact
• 📖 Add Detail - Expand with more comprehensive information and context
• 🔧 Fix Grammar - Correct grammar, spelling, and punctuation errors
• 🚀 Optimize for AI - Improve text for better AI model understanding
• 📋 Reformat - Restructure for better organization and readability
• 💼 Make Professional - Convert to professional tone and style
• 🎯 Custom Enhancement - Specify your own improvement instructions

📝 How to Use AI Enhancement

Method 1: Improve Selected Text

1. Select text in any editor (code, markdown, plain text)
2. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
3. Run command: "Gately AI Prompt Manager: Improve Selected Text"
4. Choose enhancement type from the picker
5. Select your action when enhancement completes

Method 2: Improve from Clipboard

1. Copy text to clipboard from anywhere
2. Run the improve command (no text selection needed)
3. Confirm to use clipboard text or enter manually
4. Choose enhancement type and proceed

Method 3: Improve Existing Prompts

1. Right-click any prompt in the Prompt Manager tree
2. Select "Improve with AI" from context menu
3. Choose enhancement type
4. Decide how to handle the improved version

🎯 Action Options After Enhancement

When AI enhancement completes, you get 6 flexible options:

• $(check) Apply Changes - Replace original text with enhanced version
• $(add) Create New Prompt - Save enhanced text as a new prompt in manager
• $(diff) Show Comparison - View side-by-side diff of original vs enhanced
• $(copy) Copy to Clipboard - Copy enhanced text for use elsewhere
• $(comment-discussion) Send to Chat - Open enhanced text in chat interface
• $(x) Reject Changes - Keep original text unchanged

⚙️ AI Provider Setup

1. Open AI Settings: Command Palette → "Gately AI Prompt Manager: Open AI Settings"
2. Configure Provider: Choose and configure your preferred AI provider
3. Add API Key: Enter your API key for the selected provider
4. Test Connection: Verify the setup works correctly

💡 Tips for Best Results

• Be specific with custom enhancement instructions
• Use appropriate enhancement types for your content
• Review changes using the comparison view before applying
• Save good results as new prompts for future reference

🛠 Core Features

Prompt Management

• Create Prompts - Support for title, content, description, tags, and categories
• Edit Prompts - Modify anytime with automatic save of modification time
• Delete Prompts - Support for individual deletion and batch cleanup
• Simple Management - Easy organization with category-based structure

Category System

• Default Categories - Three basic categories: General, Programming, Writing
• Custom Categories - Create personalized category structures
• Category Operations - Support for editing, deleting, and exporting entire categories
• Uncategorized Management - Automatically collect uncategorized prompts

Search & Filtering

• Real-time Search - Search as you type, supports both Chinese and English
• Multi-field Search - Search across titles, content, descriptions, tags, and category names
• Search Highlighting - Clear display of matching results
• Search History - Remember commonly used search terms

🎨 User Interface

Activity Bar View

• Prompt Tree List - Display all prompts organized by category hierarchy
• Context Menu - Quick access to edit, delete, copy and other operations
• Search Box - Real-time filtering of displayed results
• Toolbar Buttons - Common functions like add, refresh, settings

Quick Picker

• Smart Sorting - Based on usage frequency and update time
• Preview Information - Display prompt content preview
• Category Indicators - Clear display of category membership
• Operation Hints - Show available operation methods

📖 Usage Guide

Basic Operations

1. Creating Prompts

Method 1: Activity Bar → Click ➕ button
Method 2: Command Palette → "Gately AI Prompt Manager: Add New Prompt"
Method 3: Shortcut Shift+P → Select "Add New Prompt"

2. Using Prompts

Method 1: Activity Bar → Double-click prompt item
Method 2: Shortcut Shift+P → Select prompt
Method 3: Right-click menu → "Copy to Clipboard" or "Send to Chat"

3. Managing Categories

Create Category: Right-click empty area in Activity Bar → "Add Category"
Edit Category: Right-click category → "Edit Category"
Delete Category: Right-click category → "Delete Category"

Advanced Features

Smart Search

// Search syntax examples
code          # Search all content containing "code"
react hooks   # Search React Hooks related content
@programming  # Search content in programming category
#bug         # Search prompts containing bug tag

Batch Operations

Export All: Command Palette → "Gately AI Prompt Manager: Export Prompts"
Export Category: Right-click category → "Export Category"
Import Data: Command Palette → "Gately AI Prompt Manager: Import Prompts"

AI Enhancement Operations

Improve Selected Text: Command Palette → "Gately AI Prompt Manager: Improve Selected Text"
Improve from Clipboard: Run improve command without text selection
Improve Existing Prompt: Right-click prompt → "Improve with AI"
Open AI Settings: Command Palette → "Gately AI Prompt Manager: Open AI Settings"

⌨️ Keyboard Shortcuts

💡 Tip: Keyboard shortcuts can be customized in settings

⚙️ Configuration

Default Action Mode

{
  "promptManager.defaultAction": "copy" // or "chat"
}

• copy - Copy to clipboard when selecting a prompt
• chat - Send to chat interface when selecting a prompt

AI Provider Configuration

{
  "promptManager.ai.apiKey": "your-openai-api-key",
  "promptManager.ai.model": "gpt-4", // "gpt-4" or "gpt-3.5-turbo"
  "promptManager.ai.enabled": true
}

Custom Configuration File Location

Windows: %APPDATA%\Code\User\settings.json
macOS: ~/Library/Application Support/Code/User/settings.json
Linux: ~/.config/Code/User/settings.json

💾 Import/Export

Supported Formats

• JSON Format - Standard data exchange format
• Version Compatibility - Supports backward-compatible version upgrades
• Integrity Verification - Automatic data format validation during import

Export Data Structure

{
  "version": "1.0.0",
  "exportedAt": "2024-01-01T00:00:00.000Z",
  "prompts": [
    {
      "id": "unique-id",
      "title": "Prompt Title",
      "content": "Prompt Content",
      "description": "Description Information",
      "categoryId": "Category ID",
      "tags": ["Tag1", "Tag2"],
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-01T00:00:00.000Z",
      "usageCount": 0
    }
  ],
  "categories": [
    {
      "id": "category-id",
      "name": "Category Name",
      "description": "Category Description",
      "icon": "Icon Name",
      "sortOrder": 0,
      "createdAt": "2024-01-01T00:00:00.000Z"
    }
  ],
  "metadata": {
    "totalCount": 1,
    "categoryCount": 1,
    "exportedBy": "Gately AI Prompt Manager"
  }
}

Import Notes

• Conflict Handling - Prompts with the same ID will be overwritten
• Category Creation - Non-existent categories will be automatically created
• Data Validation - Invalid data will be filtered but won't affect import

🔗 Editor Integration

Cursor Integration

• Environment Detection - Automatically recognize Cursor environment
• Chat Commands - Send directly to Cursor Chat
• Quick Operations - Support right-click menu sending

VSCode Integration

• Native Support - Perfect compatibility with VSCode environment
• Command Palette - All features accessible through command palette
• Settings Sync - Support VSCode settings synchronization

Universal Features

• Clipboard Integration - One-click copy prompt content
• Editor Insertion - Direct insertion at current editor position
• Smart Recognition - Automatically select optimal integration method based on environment

🏗 Technical Architecture

Core Design Patterns

• Singleton Pattern - PromptManager and various Service instances
• Factory Pattern - ChatIntegrationFactory automatically selects integration services
• Strategy Pattern - PromptActionStrategies handle different operations
• Event-Driven - Reactive UI update mechanism

Service Layer Architecture

PromptManager (Core Business Logic)
├── StorageService (Data Persistence)
├── UIService (User Interface)
├── ClipboardService (Clipboard Operations)
├── ImportExportService (Import/Export)
├── ChatIntegrationFactory (Chat Integration)
│   ├── CursorIntegrationService
│   └── VSCodeIntegrationService
└── EditorEnvironmentDetector (Environment Detection)

Data Flow

UI Operations → PromptManager → Service Layer → Storage Layer
                             ↓
                   Event Notifications → UI Updates

❓ FAQ

Q: How much storage space does the extension use?

A: The extension itself is about 2MB, with prompt data stored in VSCode's globalState, typically ranging from a few KB to several MB.

Q: Is the data secure? Will it be lost?

A: Data is stored in VSCode's official storage mechanism, with the same security level as VSCode settings. Regular export backups are recommended.

Q: Does it support team sharing?

A: Team sharing can be achieved through export/import functionality. Cloud sync features may be considered in future versions.

Q: Why isn't Chat integration working?

A: Please check: 1) Whether you're in a supported editor 2) Editor version compatibility 3) Whether there's an active editor window

Q: Can I modify the default example prompts?

A: Yes, all prompts (including examples) can be freely edited or deleted.

Q: Does it support Markdown format?

A: Prompt content supports any plain text format, including Markdown, code, etc.

Q: How do I set up AI enhancement features?

A: Use Command Palette → "Gately AI Prompt Manager: Open AI Settings" to configure your preferred AI provider and API key.

Q: Which AI providers are supported?

A: Currently supports OpenAI with GPT-4 and GPT-3.5-turbo models. You need a valid OpenAI API key to use the enhancement features.

Q: Is my data sent to AI providers secure?

A: Yes, text is sent securely via HTTPS to the configured AI provider only during enhancement operations. No data is stored by the providers beyond processing your request.

Q: Can I use AI enhancement without an API key?

A: No, AI enhancement requires a valid API key from one of the supported providers. The extension will guide you through the setup process.

Q: What happens if AI enhancement fails?

A: The extension will show an error message and fall back gracefully. Your original text is never modified unless you explicitly choose to apply changes.

Q: Can I customize the AI enhancement behavior?

A: Yes, you can choose from 8 different enhancement types including custom instructions, and select from 6 different actions after enhancement completes.

🆘 Support & Feedback

Issue Reporting

• Technical Support - Contact us through VS Code Marketplace reviews or extension page
• Feature Requests - Submit feature requests via marketplace feedback

Feedback & Suggestions

• User Feedback - Share your experience and suggestions with us
• Usage Examples - Help improve documentation with real-world use cases
• Bug Reports - Detailed error reproduction steps help us improve quality

Version History

• v0.0.1 - Initial version with core features
• v0.0.3 - Added AI-powered text enhancement with OpenAI integration
  • ✨ 8 enhancement types including custom instructions
  • 🎯 6 flexible action options after enhancement
  • 🔧 Improved UI flow with progress notifications
  • 📝 Enhanced prompt management with AI assistance

Acknowledgments

Thanks to all users for their feedback and suggestions that make this extension better!