Prompt Launcher - Relinns AI Toolkit Extension

A powerful VS Code extension for accessing AI-powered prompts to enhance your development workflow

🎉 What's New in v2.0.0

The Prompt Launcher is now FULLY FUNCTIONAL!

This release fixes critical authentication issues that prevented users from signing in. The extension is now ready for production use.

✅ Major Fixes

• Fixed infinite loading after authentication
• Fixed user profile fetching flow
• Fixed polling timer calculations
• Added comprehensive error handling
• Enhanced cross-window synchronization

See full changelog

📖 Table of Contents

• Features
• Installation
• Getting Started
• Usage
• Configuration
• Authentication Flow
• Troubleshooting
• Development
• Contributing
• License

✨ Features

🔐 Secure Google OAuth Authentication

• Device code flow for secure sign-in
• Cross-window authentication synchronization
• Automatic token refresh
• Secure credential storage

🚀 AI-Powered Prompts

• Access curated AI prompts for development
• Personalized prompt recommendations
• Quick search and filter functionality
• Category-based organization

💼 Professional UI

• Modern, VS Code-integrated interface
• Responsive design for all screen sizes
• Real-time authentication status
• Intuitive prompt library browser

🔄 Seamless Integration

• Works across multiple VS Code windows
• Automatic prompt library launch after sign-in
• Persistent authentication state
• One-click sign out from any window

📥 Installation

From VS Code Marketplace

1. Open VS Code
2. Press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (Mac) or go to extensions directly.
3. Search for "Relinns AI Toolkit"
4. Click Install

Manual Installation

1. Download the .vsix file from releases
2. Open VS Code
3. Go to Extensions (Ctrl+Shift+X)
4. Click ... menu → Install from VSIX
5. Select the downloaded .vsix file

🚀 Getting Started

Prerequisites

• VS Code version 1.75.0 or higher
• Active internet connection
• Google account for authentication

First-Time Setup

1. Open Command Palette

   • Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
   • Or press F1

2. Launch Prompt Launcher

   • Type: Prompt Launcher: Launch Prompt
   • Press Enter

3. Sign In

   • Click "Sign In with Google"
   • Copy the verification code shown
   • Click "Open Browser"
   • Paste the code in your browser
   • Approve the access request

4. Start Using Prompts

   • After 2-3 seconds, the Prompt Library opens automatically
   • Browse, search, and use AI prompts in your workflow

💻 Usage

Available Commands

Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and use:

Keyboard Shortcuts

You can customize these in VS Code Keyboard Shortcuts (Ctrl+K Ctrl+S):

{
  "key": "ctrl+alt+p",
  "command": "promptLauncher.launchPrompt"
}

⚙️ Configuration

Required Settings

The extension requires Google OAuth credentials. Set these in VS Code settings:

1. Open Settings: Ctrl+, (Windows/Linux) or Cmd+, (Mac)
2. Search for: Relinns AI Toolkit
3. Configure:

{
  "relinnsAiToolkit.googleClientId": "YOUR_CLIENT_ID.apps.googleusercontent.com",
  "relinnsAiToolkit.googleClientSecret": "YOUR_CLIENT_SECRET"
}

Getting OAuth Credentials

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Enable Google+ API
4. Go to Credentials → Create Credentials → OAuth 2.0 Client ID
5. Choose "TV and Limited Input devices" as application type
6. Copy the Client ID and Client Secret
7. Add them to VS Code settings

⚠️ Important: Must use "TV and Limited Input devices" type for device code flow.

🔒 Authentication Flow

How It Works

┌─────────────┐
│   VS Code   │
│   User      │
└──────┬──────┘
       │ 1. Click "Sign In"
       ▼
┌──────────────────────────┐
│  Prompt Launcher         │
│  Requests Device Code    │
└──────┬───────────────────┘
       │ 2. Shows verification code
       │    (e.g., "ABC-DEFG")
       ▼
┌──────────────────────────┐
│  User Browser            │
│  https://google.com/     │
│  device                  │
└──────┬───────────────────┘
       │ 3. User enters code
       │    and approves access
       ▼
┌──────────────────────────┐
│  Google OAuth Server     │
│  Returns Access Token    │
└──────┬───────────────────┘
       │ 4. Extension receives token
       │
       ▼
┌──────────────────────────┐
│  Fetch User Profile      │
│  Store Authentication    │
└──────┬───────────────────┘
       │ 5. Show success screen
       │
       ▼
┌──────────────────────────┐
│  Prompt Library Opens    │
│  User can browse prompts │
└──────────────────────────┘

Security Features

• ✅ OAuth 2.0 device code flow (secure for desktop apps)
• ✅ No client secret exposed to users
• ✅ Tokens stored in VS Code's secure secret storage
• ✅ Automatic token refresh before expiration
• ✅ Cross-window state synchronization
• ✅ One-click sign out from all windows

🐛 Troubleshooting

Issue: "Waiting for you to complete sign-in..." Never Ends

Symptoms: Loading spinner continues forever after entering code in browser.

Solution: This was a critical bug fixed in v2.0.0. Please update to the latest version:

1. Go to Extensions in VS Code
2. Find "Relinns AI Toolkit"
3. Click Update

Issue: "OAuth Client Configuration Error"

Symptoms: Error message about client_secret or client type.

Solution:

1. Ensure you created a "TV and Limited Input devices" OAuth client, NOT "Web application"
2. Delete old credentials from Google Cloud Console
3. Create new credentials with correct type
4. Update VS Code settings with new credentials

Issue: Authentication Works But No Prompts Show

Symptoms: Successfully signed in but prompt library is empty.

Solution:

1. Check internet connection
2. Try signing out and signing back in
3. Run command: Prompt Launcher: Check Auth Status
4. Check VS Code Output console for errors

Issue: Sign-In Required on Every VS Code Restart

Symptoms: Extension doesn't remember authentication between sessions.

Solution:

1. Check VS Code secret storage isn't blocked by antivirus
2. Ensure you have write permissions in VS Code config folder
3. Try command: Prompt Launcher: Clear All Auth then sign in again

Debugging Steps

1. Check Extension Logs

   • Open Output panel: View → Output
   • Select "Prompt Launcher" from dropdown
   • Look for ✅ success or ❌ error indicators

2. Verify OAuth Configuration

   • Run command: Prompt Launcher: Test OAuth Config
   • This will validate your Google OAuth setup

3. Clear and Retry

   • Run: Prompt Launcher: Clear All Auth
   • Restart VS Code
   • Try signing in again

4. Check Console Logs

   • Open Help → Toggle Developer Tools
   • Go to Console tab
   • Try authentication again
   • Look for specific error messages

👨‍💻 Development

Prerequisites for Development

• Node.js 16.x or higher
• npm 8.x or higher
• VS Code 1.75.0 or higher

Setup Development Environment

# Clone the repository
git clone https://github.com/your-repo/prompt-launcher.git
cd prompt-launcher

# Install dependencies
npm install

# Open in VS Code
code .

# Press F5 to start debugging

Project Structure

prompt-launcher/
├── src/
│   ├── auth/
│   │   ├── authenticationManager.ts      # Main auth orchestrator
│   │   ├── deviceCodeFlow.ts             # OAuth device code flow
│   │   ├── authenticationWebview.ts      # Sign-in UI
│   │   ├── tokenManager.ts               # Token storage/refresh
│   │   └── userProfileManager.ts         # User profile handling
│   ├── config/
│   │   └── authConfig.ts                 # OAuth configuration
│   ├── types/
│   │   └── auth.ts                       # TypeScript interfaces
│   ├── services/
│   │   └── promptLibraryManager.ts       # Prompt library logic
│   └── extension.ts                      # Extension entry point
├── package.json
├── tsconfig.json
└── README.md

Key Files Explained

extension.ts

Entry point of the extension. Handles:

• Extension activation
• Command registration
• Event handler setup
• Authentication flow coordination

authenticationManager.ts

Core authentication logic:

• Manages authentication state
• Coordinates sign-in/sign-out
• Handles cross-window synchronization
• Manages event callbacks

deviceCodeFlow.ts

Implements OAuth 2.0 device code flow:

• Requests device codes from Google
• Polls for user authorization
• Exchanges codes for access tokens
• Handles all OAuth error scenarios

authenticationWebview.ts

Renders the sign-in UI:

• Shows device codes to users
• Displays authentication status
• Handles user interactions
• Updates UI based on auth state

Tips for Best Results

1. Add Context — After pasting the prompt, add your specific code or requirements
2. Be Specific — Include file names, error messages, or expected behavior
3. Iterate — Use the AI response as a starting point and refine as needed
4. Save Favorites — Create workspace-specific prompts for recurring tasks

Troubleshooting

Extension not working?

1. Check Configuration — Ensure all settings are configured correctly
2. Reload VS Code — Press Cmd+Shift+P → "Developer: Reload Window"
3. Check Authentication — Try signing out and signing in again

Prompts not loading?

1. Check Network — Ensure you have internet connectivity
2. Verify API URL — Confirm the API Base URL is correct in settings
3. Contact Admin — The API server might be temporarily unavailable

Clipboard not working?

1. Ensure VS Code has clipboard permissions
2. Try using Cmd+V / Ctrl+V to paste manually

Requirements

• Visual Studio Code 1.85.0 or higher
• Internet connection for authentication and prompt syncing
• Valid configuration credentials from your administrator

Support

Having issues? Contact your administrator or IT support team.

Made with ❤️ by Relinns Technologies