---

📖 Table of Contents

• 🎯 Overview
• ✨ Features
• 🚀 Quick Start
• 💡 Usage Examples
• 🔧 Configuration
• 🤖 Supported AI Providers
• 🛠️ Template System
• 📦 Installation Methods
• 🏗️ Building from Source
• 🧰 Tech Stack
• 🤝 Contributing
• 📄 License
• 🌟 Acknowledgements

---

🎯 Overview

AI Prompt Generator is a powerful PowerToys Run plugin that leverages AI to transform your short, rough ideas into detailed, well-structured prompts. Whether you're working with ChatGPT, Claude, or any other AI assistant, this plugin helps you craft professional-grade prompts in seconds.

Why Use This Plugin?

Key Highlights

• 🧠 AI-Powered Expansion - Transforms short prompts into comprehensive, structured instructions
• 🌐 Multi-Provider Support - Works with OpenAI, Groq, OpenRouter, HuggingFace, SambaNova
• ⚡ Lightning Fast - Integrated into PowerToys Run for instant access
• 💾 Smart Caching - Reduces API calls and costs by caching responses
• 🎨 Customizable - Adjust temperature, max tokens, and system prompts
• 🔒 Privacy First - Your API keys are stored securely in Windows settings
• 📋 One-Click Copy - Results automatically copied to clipboard

---

✨ Features

🎯 Core Features

🎨 Advanced Capabilities

• 📝 Custom System Prompts - Define how AI should expand your prompts
• 🎚️ Temperature Control - Adjust creativity from focused (0.0) to creative (2.0)
• ⏱️ Timeout Management - Configure request timeouts (5-120 seconds)
• 📊 Token Usage Tracking - Monitor API consumption (optional)
• 🔄 Context Menu Actions - Quick copy, re-expand, and more
• 🌓 Theme Support - Automatic light/dark mode icons

---

🚀 Quick Start

Prerequisites

✅ Windows 10/11 (x64 or ARM64) ✅ PowerToys v0.87.0 or later ✅ API key from one of the supported providers

Installation (3 Easy Steps)

1️⃣ Download the Plugin

Choose your architecture:

• x64 - For Intel/AMD processors
• ARM64 - For ARM-based Windows devices

2️⃣ Install the Plugin

1. Extract the downloaded ZIP file
2. Copy the extracted folder to:

   %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins\
   

3. The path should look like:

   C:\Users\YourName\AppData\Local\Microsoft\PowerToys\PowerToys Run\Plugins\AIPromptGenerator\
   

3️⃣ Configure & Restart

1. Restart PowerToys
2. Press Alt+Space to open PowerToys Run
3. Type aipromptgenerator - you'll see a configuration prompt
4. Open PowerToys Settings → PowerToys Run → AI Prompt Generator
5. Configure your API key and provider

🎉 Done! You're ready to generate amazing prompts!

---

💡 Usage Examples

Basic Usage

Alt+Space → aipromptgenerator write a blog post

Short Input:

write a blog post

AI-Expanded Output:

You are a professional content writer with expertise in creating engaging blog posts.

## Task
Write a comprehensive blog post that educates and engages readers.

## Requirements
- **Format**: Blog post with clear sections (Introduction, Body with 3-5 master points, Conclusion)
- **Tone**: Conversational yet informative
- **Length**: 800-1200 words
- **Style**: Use subheadings, bullet points, and short paragraphs for readability

## Structure
1. **Introduction** (100-150 words)
   - Hook the reader with a compelling opening
   - State the master topic and its relevance
   - Preview the key points

2. **Body** (600-900 words)
   - Present 3-5 master points with supporting details
   - Use examples, statistics, or anecdotes
   - Include actionable insights

3. **Conclusion** (100-150 words)
   - Summarize key takeaways
   - Call-to-action or final thoughts

## Additional Guidelines
- Use active voice and clear language
- Avoid jargon unless explained
- Include relevant keywords naturally
- mastertain consistent voice throughout

More Examples

Code Generation

Input: create a REST API
Output: Structured prompt with architecture requirements, endpoints, error handling, authentication, testing strategies, and documentation requirements

Data Analysis

Input: analyze sales data
Output: Detailed prompt specifying data format, analysis methods, visualization requirements, insights to extract, and reporting format

Creative Writing

Input: story about time travel
Output: Comprehensive prompt with genre, characters, plot structure, themes, world-building, and narrative style guidelines

---

🔧 Configuration

Access Settings

1. Open PowerToys Settings
2. Navigate to PowerToys Run → Plugins
3. Find AI Prompt Generator
4. Click Additional Options

Configuration Options

Example Configuration

For Cost-Effective Usage (Groq):

Provider: Groq
Model: llama-3.3-70b-versatile
Temperature: 0.7
Max Tokens: 1500
Enable Caching: Yes

For Best Quality (OpenAI):

Provider: OpenAI
Model: gpt-4o
Temperature: 0.8
Max Tokens: 2500
Enable Caching: Yes

For Coding Tasks (OpenRouter - Free!):

Provider: OpenRouter
Model: kwaipilot/kat-coder-pro:free
Temperature: 0.7
Max Tokens: 2000
Enable Caching: Yes

💡 Tip: KAT Coder Pro handles coding-related prompts exceptionally well and is completely free via OpenRouter!

---

🤖 Supported AI Providers

1. OpenAI 🟢

• Models: gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-3.5-turbo
• Best For: High-quality, balanced responses
• API Key: Get from OpenAI Platform
• Endpoint: https://api.openai.com/v1/chat/completions (auto-configured)

2. Groq ⚡

• Models: llama-3.3-70b-versatile, llama-3.1-70b-versatile, mixtral-8x7b-32768
• Best For: Ultra-fast responses, cost-effective
• API Key: Get from Groq Console
• Endpoint: https://api.groq.com/openai/v1/chat/completions (auto-configured)

3. OpenRouter 🔀

• Models: openai/gpt-4o, anthropic/claude-3.5-sonnet, google/gemini-pro-1.5, kwaipilot/kat-coder-pro:free
• Best For: Access to multiple models with one API key
• Recommended: kwaipilot/kat-coder-pro:free - Excellent coding assistance, completely free!
• API Key: Get from OpenRouter
• Endpoint: https://openrouter.ai/api/v1/chat/completions (auto-configured)

4. HuggingFace 🤗

• Models: meta-llama/Llama-3.1-70B-Instruct, mistralai/Mixtral-8x7B-Instruct-v0.1
• Best For: Open-source models, research
• API Key: Get from HuggingFace
• Endpoint: https://api-inference.huggingface.co/models/ (auto-configured)

5. SambaNova 🚀

• Models: Meta-Llama-3.1-70B-Instruct, Meta-Llama-3.1-8B-Instruct
• Best For: Enterprise-grade inference
• API Key: Get from SambaNova
• Endpoint: https://api.sambanova.ai/v1/chat/completions (auto-configured)

Cost Comparison (Approximate)

---

🛠️ Template System

This repository also includes PowerToys Run Plugin Templates - a comprehensive dotnet template system for creating new PowerToys Run plugins.

📦 Template Package

Located in the src/templates/ directory, this NuGet package provides:

• 🎯 Project Template (ptrun-proj) - Scaffold a single plugin project
• 🎯 Solution Template (ptrun-sln) - Scaffold a complete solution with plugin + unit tests
• 📝 Pre-configured project structure
• 🖼️ Icon placeholders (light/dark themes)
• ✅ Unit test setup (optional)
• 🔧 Build scripts and configuration

Installing Templates

# Install from NuGet
dotnet new install Community.PowerToys.Run.Plugin.Templates

# Or install locally
dotnet new install ./src

Using Templates

Create a Simple Project

dotnet new ptrun-proj -n MyAwesomePlugin -o MyAwesomePlugin

This creates:

MyAwesomePlugin/
├── Images/
│   ├── myawesomeplugin.dark.png
│   └── myawesomeplugin.light.png
├── master.cs
├── plugin.json
└── MyAwesomePlugin.csproj

Create a Complete Solution

dotnet new ptrun-sln -n MyAwesomePlugin -o MyAwesomePlugin

This creates:

MyAwesomePlugin/
├── MyAwesomePlugin.sln
├── Community.PowerToys.Run.Plugin.MyAwesomePlugin/
│   ├── Images/
│   ├── master.cs
│   ├── plugin.json
│   └── *.csproj
└── Community.PowerToys.Run.Plugin.MyAwesomePlugin.UnitTests/
    ├── masterTests.cs
    └── *.csproj

Template Options

# Custom author
dotnet new ptrun-proj -n MyPlugin --PluginAuthor "Your Name"

# Without test project
dotnet new ptrun-sln -n MyPlugin --TestProject false

Template Structure

The template system includes:

• Project Template (src/templates/project/)

  • Minimal plugin structure
  • Single project file
  • Icon placeholders
  • Basic master.cs implementation

• Solution Template (src/templates/solution/)

  • Complete solution with .sln file
  • master plugin project
  • Unit test project (optional)
  • Pre-configured test setup

• Scripts (src/templates/scripts/)

  • Helper scripts for development
  • Linting and validation tools

Building the Template Package

cd src
dotnet pack

Output: Community.PowerToys.Run.Plugin.Templates.{version}.nupkg

---

📦 Installation Methods

Method 1: Manual Installation (Recommended)

1. Download the latest release ZIP file
2. Extract to PowerToys plugin directory:

   %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins\
   

3. Restart PowerToys

Method 2: Script Installation

# Windows Command Prompt
install-local.bat

This script:

• Builds the plugin
• Copies files to the correct location
• Restarts PowerToys automatically

Method 3: Build and Install

# Linux/WSL
./build-and-zip.sh

# Then manually extract to plugins directory

---

🏗️ Building from Source

Prerequisites

• .NET 9.0 SDK or later
• Visual Studio 2022 or Visual Studio Code
• PowerToys v0.87.0 or later (for testing)

Clone the Repository

git clone https://github.com/ruslanlap/PowerToysRun-AIPromptGenerator.git
cd PowerToysRun-AIPromptGenerator

Build the Plugin

Using Visual Studio

1. Open AIPromptGenerator/AIPromptGenerator.sln
2. Set build configuration to Release
3. Select platform: x64 or ARM64
4. Build → Build Solution (Ctrl+Shift+B)

Using Command Line

cd AIPromptGenerator
dotnet restore
dotnet build -c Release -p:Platform=x64

Output:

AIPromptGenerator/Community.PowerToys.Run.Plugin.AIPromptGenerator/bin/x64/Release/net9.0-windows10.0.22621.0/

Build the Templates

cd src
dotnet pack -c Release

Output:

src/bin/Release/Community.PowerToys.Run.Plugin.Templates.{version}.nupkg

Install Locally

# Copy plugin to PowerToys
xcopy /E /I /Y "AIPromptGenerator\Community.PowerToys.Run.Plugin.AIPromptGenerator\bin\x64\Release\net9.0-windows10.0.22621.0" "%LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins\AIPromptGenerator"

# Restart PowerToys
taskkill /F /IM PowerToys.exe
start "" "C:\Program Files\PowerToys\PowerToys.exe"

Run Tests

cd AIPromptGenerator
dotnet test

Build Scripts

The repository includes helpful build scripts:

• build-and-zip.sh - Linux/WSL build script with ZIP creation
• install-local.bat - Windows automatic build and install
• pack.bat - Create NuGet template package
• ptrun-lint.sh - Code quality checks

---

🧰 Tech Stack

---

🤝 Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or code contributions, we appreciate your help.

How to Contribute

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature
   

3. Make your changes
   • Follow the existing code style
   • Add tests if applicable
   • Update documentation
4. Commit your changes

   git commit -m "Add amazing feature"
   

5. Push to your fork

   git push origin feature/amazing-feature
   

6. Open a Pull Request

Development Guidelines

• ✅ Follow C# coding conventions
• ✅ Use nullable reference types (#nullable enable)
• ✅ Write XML documentation comments
• ✅ Add unit tests for new features
• ✅ Test on both x64 and ARM64 if possible
• ✅ Update README for significant changes

Reporting Issues

Found a bug? Have a feature request? Please open an issue with:

• 🐛 Bug Reports: Steps to reproduce, expected vs actual behavior, error messages
• 💡 Feature Requests: Use case, proposed solution, alternatives considered
• 📚 Documentation: What's unclear or missing

---

📄 License

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

MIT License

Copyright (c) 2025 ruslanlap

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

---

🌟 Acknowledgements

Built With Love Using

• 💪 Microsoft PowerToys - The amazing launcher framework
• 🎨 Icons8 - Beautiful icons used in this README
• 🤖 OpenAI, Groq, Anthropic, HuggingFace, SambaNova - AI providers powering the intelligence
• 📚 Community.PowerToys.Run.Plugin.Dependencies - Essential plugin development package

Inspired By

• 🧠 Prompt Engineering Best Practices - Community knowledge on effective prompt design
• 🎯 Developer Productivity Tools - Making workflows faster and smoother

Special Thanks

• The PowerToys team for creating an extensible platform
• The open-source community for inspiration and feedback
• All contributors who help improve this plugin

---

---