ENHANCE ✨ Your AI Prompts, Instantly.

Tired of generic AI responses? enhance-this is your secret weapon. This lightning-fast CLI tool transforms your simple ideas into rich, detailed prompts, ensuring you get the best possible output from any AI model. It runs locally using Ollama or any hosted API (OpenRouter, OpenAI, Groq, ...) with your own key.

Whether you're a developer, writer, student, or AI enthusiast, enhance-this makes your interactions with AI more powerful and intuitive.

🚀 Why You'll Love enhance-this

• Elevate Your Prompts: Go from a basic idea like "write a blog post about AI" to a meticulously crafted prompt that gets superior results.
• Boost Productivity: Automate prompt engineering. Get the perfect prompt copied to your clipboard in seconds.
• Stay Private (or not): Powered by your local Ollama models by default, so your data never leaves your computer. Need more speed on a low-end PC? Use a hosted API with your own key.
• Your Key, Your Choice: Switch between local Ollama (auto-detected, choose any installed model) and a hosted API provider (OpenRouter, OpenAI, Groq, ...), and your chosen model is remembered.
• Save Time & Effort: Free yourself from the tedious task of writing detailed prompts.
• Get Professional Results: Consistently achieve better outputs from any AI model.

✨ Features

• Live Enhancement: Watch your prompt get enhanced in real-time, right in your terminal.
• Interactive Mode: Iteratively refine prompts in a session with enhance --interactive.
• Two Backends: Use local Ollama (auto-detect models, download one with enhance --auto-setup) or bring your own API key for OpenRouter / OpenAI / Groq and friends.
• Model Memory: Pick an API model once with --model and it's remembered across runs.
• Customizable Styles: Choose from built-in styles (detailed, creative, technical) or create your own.
• Diff View: Instantly see what's been improved with the --diff flag.
• Seamless Workflow: Automatically copies the final prompt, ready to paste anywhere.
• History Tracking: Revisit your best prompts with enhance --history.
• Configuration Wizard: First-time setup made easy with an interactive configuration wizard.
• Visual Template Editor: Create and edit custom prompt templates with your preferred text editor.

💼 Use Cases

enhance-this is perfect for...

• Developers: Generating better code review prompts and technical documentation.
• Content Creators: Crafting compelling blog posts and social media content.
• Students & Researchers: Creating detailed research prompts and academic outlines.
• Business Professionals: Developing persuasive emails, reports, and presentations.

Example - Developer Workflow:

# From a vague idea...
enhance "review my Python code"

# ...to a precise prompt.
# Output: "Conduct a comprehensive code review of the provided Python code. Focus on: PEP 8 compliance, code readability, potential bugs, performance optimizations, security vulnerabilities, and adherence to Python best practices..."

Example - Content Creation:

# From a simple topic...
enhance "write about sustainable fashion" -s creative

# ...to a detailed content brief.
# Output: "Create an engaging, well-researched article about sustainable fashion that captivates environmentally conscious readers. Include: compelling statistics, innovative materials, practical tips, and inspiring success stories..."

⚡ Get Started in Minutes

No Ollama? No problem — you can use a hosted API right away:

# Use OpenRouter (or any OpenAI-compatible API) with your own key
pip install enhance-this
enhance --provider api --api-key sk-or-... --save-key "review my Python code"

Prefer fully-local? Install Ollama, then:

pip install enhance-this
enhance --auto-setup          # downloads a recommended model automatically
enhance "review my Python code"

NPM:

npm install -g enhance-this

🛠 Configuration Wizard

Setting up enhance-this has never been easier! Run the interactive configuration wizard to customize your experience:

enhance --config-wizard

The wizard will guide you through:

• Choosing your backend: Ollama (local) or API (bring your own key)
• Setting your Ollama host address (Ollama) / API provider + key + default model (API)
• Choosing your preferred enhancement style
• Configuring generation temperature
• Setting maximum response length
• Enabling/disabling automatic clipboard copying
• Selecting your preferred AI models

🎨 Visual Template Editor

Create custom prompt templates with our built-in visual editor that integrates with your preferred text editor:

enhance --template-editor

Features:

• Edit existing templates or create new ones
• Integration with your system's default text editor (nano, vim, emacs, etc.)
• Built-in templates as starting points
• Custom template management
• Real-time preview of template structure

The template editor will automatically use your system's default editor (defined by the $EDITOR environment variable) or fall back to nano if none is set.

💡 How to Use

⚙️ Advanced Configuration

Customize enhance-this via ~/.enhance-this/config.yaml and add your own prompt styles in ~/.enhance-this/templates/.

🤝 Join Our Community!

Have ideas or found a bug? We'd love your help to make enhance-this even better. Check out our CONTRIBUTING.md to get started.

Love enhance-this? Star 🌟 us on GitHub and share it with your network!

📄 License

This project is open-source and available under the MIT License. See the LICENSE file for more details.