PromptForgeAI VS Code Extension

A lightweight, robust VS Code extension that connects your development environment to the PromptForgeAI Brain & Demon engines for intelligent prompt enhancement and code suggestions.

🚀 Features

• Device Flow Authentication - Secure OAuth2 device flow login
• Circuit Breaker Pattern - Resilient API client with automatic failure handling
• Quick Prompt Upgrade - Fast enhancement using Brain Engine
• Deep Prompt Upgrade - Advanced multi-variant upgrades via Demon Engine
• Contextual Suggestions - Smart code and text suggestions
• Real-time Status - Live connection status in status bar
• Feature Flags - Dynamic feature toggling

📦 Installation

From Source

1. Clone this repository
2. npm install
3. npm run compile
4. Press F5 in VS Code to run in Extension Development Host

Configuration

Configure the extension in your VS Code settings:

{
  "promptforge.apiBase": "http://localhost:8080",
  "promptforge.clientId": "pfa_vscode_ext",
  "promptforge.enableAutoSuggestions": true
}

Or set environment variables:

• PFA_API_BASE_URL - Base URL for PromptForgeAI API
• PFA_CLIENT_ID - Client ID for device authentication

🎯 Commands

🔧 Usage

Authentication

1. Run PromptForgeAI: Login
2. Visit the provided URL and enter the device code
3. Extension will automatically authenticate once approved

Quick Upgrade

1. Select text in any file (or leave empty to upgrade entire file)
2. Run PromptForgeAI: Quick Prompt Upgrade
3. Enhanced text replaces selection

Deep Upgrade

1. Select text for enhancement
2. Run PromptForgeAI: Deep Prompt Upgrade (Demon Engine)
3. Choose from multiple upgrade variants
4. Selected variant replaces your text

Contextual Suggestions

1. Open any file with content
2. Run PromptForgeAI: Get Contextual Suggestions
3. Choose from intelligent suggestions
4. Suggestion is inserted at cursor or replaces selection

🏗️ Architecture

Core Components

• ApiClient - HTTP client with circuit breaker and keep-alive
• AuthManager - OAuth2 device flow and token management
• StatusBar - Real-time connection status indicator
• FeatureFlags - Dynamic feature configuration
• Commands - Individual command implementations

Security Features

• Secure token storage using VS Code Secrets API
• Automatic token refresh handling
• Circuit breaker prevents API spam during outages
• Input sanitization and validation

🔒 Security

• All tokens stored securely via VS Code's built-in secrets management
• No credentials stored in plain text
• Automatic token refresh with fallback to re-authentication
• Request timeout and circuit breaker prevent hanging connections

🛠️ Development

Build

npm run compile

Watch Mode

npm run watch

Test

npm test

Package

npm run vscode:prepublish

📋 Requirements

• VS Code 1.70.0 or higher
• Node.js 16+ for development
• PromptForgeAI backend service

🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details

🔗 Links

• PromptForgeAI Backend
• VS Code Extension API
• OAuth2 Device Flow

Made with 💙 by the PromptForgeAI team