Hea - AI Prompt Engineer

Your personal Prompt Engineer! A VS Code extension that transforms simple development tasks into professional, optimized prompts for any AI.

Features

• Professional Prompt Engineering: Automatically applies advanced techniques
• Intelligent Clipboard Integration: Copies optimized prompts to clipboard
• AI Enhancement: Uses Groq/Gemini to further improve your prompts
• Multi-Language Support: 6 languages with auto-detection (PT-BR, EN, ES, FR, DE, JA)
• Multiple Access Methods: Status bar, hotkeys, context menu, commands
• Secure: API keys encrypted in SecretStorage

Installation & Setup

1. Install the Extension

• VS Code Marketplace: Search for "Hea"
• Or install via .vsix file

2. Configure API Key (Required)

Choose your preferred AI provider:

Groq (Recommended - Fast)

1. Get API key: https://console.groq.com/
2. Configure: Cmd+Shift+P → Hea: Set Groq API Key
3. Paste your key (secure input)

Gemini (High Quality)

1. Get API key: https://makersuite.google.com/app/apikey
2. Configure: Cmd+Shift+P → Hea: Set Gemini API Key
3. Paste your key (secure input)
4. Switch provider: Settings → search "Hea" → change to "gemini"

3. Ready to Use

• Quick hotkey: Cmd+H or Ctrl+H
• Status bar: Click the "Hea" icon

Usage

Method 1 - Hotkey (Fastest)

1. Press: Cmd+H (Mac) or Ctrl+H (Windows/Linux)
2. Type: "Create React component"
3. Automatically: Optimized prompt copied to clipboard
4. Paste: In ChatGPT, Claude, or any AI chat

Method 2 - Status Bar

1. Click the "Hea" icon in the bottom status bar
2. Type your task
3. Optimized prompt copied automatically

Method 3 - Selected Text

1. Select any text in the editor
2. Right-click: "Optimize with Hea" in context menu
3. Selected text optimized and copied

Method 4 - Command Palette

1. Press: Cmd+Shift+P
2. Type: "Hea: Submit Task"
3. Enter your task

Prompt Engineering Techniques

Hea automatically applies:

• Chain of Thought: Structured step-by-step reasoning
• Clear Instructions: Specific and actionable directives
• Best Practices: Quality standards and documentation patterns
• Validation Guidelines: Instructions for testing and validation
• Project Context: Includes project name and development structure

Keyboard Shortcuts

• Cmd+H (Mac) / Ctrl+H (Win/Linux): Submit Task
• Cmd+Shift+H (Mac) / Ctrl+Shift+H (Win/Linux): Optimize Selection

For VS Code Developers

Compatible Editors

• Visual Studio Code
• Cursor (AI-powered editor)
• Windsurf (AI-powered editor)
• Any VS Code-based editor

Use with Any AI

• Web: ChatGPT, Claude, Gemini, etc.
• Editor: Copilot Chat, Cascade, etc.
• Desktop: Any AI application

How it works: VS Code extension → optimizes with project context → paste in any AI!

Advanced Configuration

Access via Settings (Cmd+,) → search "Hea":

Language

• hea.language: "auto", "pt-br", "en", "es", "fr", "de", "ja" (default: auto)
• How to change: Settings → search "Hea Language" → dropdown
• Auto-detection: Syncs with VS Code locale automatically
• Includes: Interface, prompts, templates, and AI responses in your language

Supported Languages

• 🇧🇷 Portuguese (Brazil) - Português brasileiro
• 🇺🇸 English - Full interface and prompts
• 🇪🇸 Spanish - Español completo
• 🇫🇷 French - Français complet
• 🇩🇪 German - Vollständiges Deutsch
• 🇯🇵 Japanese - 完全な日本語

AI Provider

• hea.provider: "groq" or "gemini" (default: groq)
• How to change: Settings → search "Hea Provider" → dropdown

Groq Models

• hea.groq.model: LLM model (default: llama3-70b-8192)
• Options: llama3-8b-8192 (fast), mixtral-8x7b-32768 (more context)
• hea.groq.baseUrl: API URL (don't modify)

Gemini Models

• hea.gemini.model: Google model (default: gemini-1.5-pro)
• Options: gemini-1.5-flash (fast), gemini-1.5-pro (quality)

Commands

• Hea: Submit Task - Optimize new task
• Hea: Set Groq API Key - Configure Groq key
• Hea: Set Gemini API Key - Configure Gemini key
• Hea: Test Clipboard - Test functionality

Security

• Encrypted API Keys in VS Code SecretStorage
• Protected Input (password) for configuration
• No Local Data Storage in files

Why Use Hea?

• 10x Better Results: Professional prompts = superior AI responses
• Lightning Fast: Cmd+H and done!
• 6 Languages: Full multi-language support with auto-detection
• 4 Usage Methods: Choose your preferred workflow
• Secure: Encrypted keys, no data leaks
• Universal: Works with any AI
• AI Enhanced: Automatically improves your prompts

Changelog

0.3.0

Enhanced multi-language experience: Optimized build system and improved language detection for all 6 supported languages.

0.2.0

Multi-language expansion: Added Spanish, French, German, and Japanese with automatic language detection based on VS Code locale.

0.1.1

UI improvements: Added professional README in English, custom logo, and enhanced marketplace presentation.

0.1.0

Core functionality: Multi-language prompts (PT-BR/EN), clipboard integration, Groq/Gemini providers, status bar access, and keyboard shortcuts.

0.0.1

Initial release: Basic commands, TreeView, Run Panel, Groq/Gemini providers, and file-based progress protocol.

License

MIT

Transform simple tasks into professional prompts with one click!