✦ Prompteiro

Enhance your AI prompts directly inside Visual Studio Code. Run local LLMs privately on your machine using Ollama or connect with your own remote API keys.

Features

• Floating Selection Action Tool: Instantly access actions (Enhance, Clarify, Add Context) whenever you select prompt candidates in your text editor.
• Side-by-Side Review Panel: Compare original and enhanced versions, view confidence ratings, and stream responses token-by-token.
• Local AI execution: Prompteiro uses Ollama to run lightweight models (Qwen 2.5 Coder, Llama 3) fully offline. Your prompts never leave your local workspace.
• Entitlement & Quotas (Spark Tier): Get 15 free daily enhancements using local models, or bring your own API key to bypass limits.
• Workspace Security Safe: Fully compatible with VS Code Workspace Trust constraints. Code extraction is disabled automatically inside untrusted workspace folders.

Requirements & Setup

For Local Mode

1. Install Ollama on your computer.
2. Prompteiro will assist you in downloading and launching your preferred model:
   • Small (Fast): qwen2.5-coder:1.5b [~1.0 GB]
   • Standard (Balanced): llama3:8b [~4.7 GB]
   • Large (Smart): llama3:70b [~40 GB+]

For Remote Mode

1. Click the status bar model indicator at the bottom right (e.g. [🤖 Local: llama3:8b]) or open Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and select Prompteiro: Show Model Switcher.
2. Select your remote provider of choice (OpenAI, Anthropic, Gemini, or Azure OpenAI).
3. Select Add Key for the provider and enter your API key in the secure input prompt (your key is saved securely in your OS keychain via VS Code's SecretStorage API).
4. For Azure OpenAI, enter your Endpoint URL (e.g. https://your-resource.openai.azure.com/) when prompted.
5. In the switcher, select the remote model you want to activate. The status bar will update to [☁ OpenAI: gpt-4o] or your selected configuration.

Secure Token & Key Storage

Prompteiro strictly adheres to VS Code security guidelines:

• No Plaintext Keys: API keys and authorization tokens are never saved to settings files, global state, or plaintext files. They reside in your system's secure keychain using the vscode.SecretStorage API.
• Direct Requests: Remote API requests are initiated client-side directly from your machine using your own key. Your keys are never transmitted to any third-party intermediate servers.

User Consent & Data Minimization

When using remote engines, Prompteiro extracts the active file metadata, symbols in scope, and up to 50 surrounding code lines to improve the meta-prompt context.

• Opt-in Modal: The first time you execute a remote enhancement, a VS Code modal dialog will ask for your explicit consent.
• Scope Restriction: Only the selected prompt text and its localized block context are sent. Full files are never scanned or uploaded.
• Untrusted Workspaces: In untrusted folders, file scanning is disabled by default to prevent any accidental code extraction.

Help & Troubleshooting

Q: The status bar shows [⚠️ Ollama offline] — how do I fix this?

Ensure the Ollama application is installed and running on your local machine. You can verify it by opening http://localhost:11434 in your browser. Once started, click the warning indicator on the status bar or trigger an enhancement to prompt a reconnect.

Q: How do I remove or rotate my API keys?

Open the Model Switcher (Prompteiro: Show Model Switcher in Command Palette), and select Remove Key next to the provider. This deletes the key immediately and permanently from your system keychain. You can then select Add Key to enter a new one.

Q: What happens when I hit the daily limit?

Free/Spark plan users get 15 local enhancements per day (resets at midnight). If you hit the limit, you can:

1. Configure remote mode with your own API key to bypass limits entirely.
2. Click Upgrade to Ignite on the limit notification to express interest in our premium plans.

Q: How do I change my remote context consent preference?

To reset your consent configuration, search for prompteiro.codeContextConsent in your VS Code Global State or reset the preference in the extension options.

Q: I skipped the initial setup. How do I open the setup/login page again?

Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and type Prompteiro: Setup & Login. This will manually reopen the onboarding and login process so you can resume where you left off.

Enjoy writing better prompts!