https://github.com/bcastelino/prompt-polish-local-extension
A Chrome extension for enhancing and organizing AI prompts, designed to work locally without any server dependencies.
https://github.com/bcastelino/prompt-polish-local-extension
css3 extension-chrome html5 javascript llm popup-window prompt-engineering
Last synced: 4 months ago
JSON representation
A Chrome extension for enhancing and organizing AI prompts, designed to work locally without any server dependencies.
- Host: GitHub
- URL: https://github.com/bcastelino/prompt-polish-local-extension
- Owner: bcastelino
- License: mit
- Created: 2025-06-13T08:12:54.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-13T19:18:25.000Z (4 months ago)
- Last Synced: 2025-06-13T20:18:42.348Z (4 months ago)
- Topics: css3, extension-chrome, html5, javascript, llm, popup-window, prompt-engineering
- Language: JavaScript
- Homepage:
- Size: 343 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Prompt Polish Local 💻
A Chrome extension for enhancing and organizing AI prompts, designed to work locally without any server dependencies.
[](https://skillicons.dev)
---
## ⚡ Features
- **Prompt Enhancement**: Instantly rewrite and optimize your prompts for better AI responses using best practices
- **Prompt Library**: Save, organize, and reuse your favorite enhanced prompts
- **Context Menu Integration**: Right-click in any text field to enhance or save prompts
- **Local Storage**: All prompts are stored locally in your browser
- **Stateless Enhancement**: Every enhancement is a new, independent task—no chat history or context is used
- **No Chatbot Integration**: You manually copy the enhanced prompt and paste it into any AI chatbot of your choice
---
## 🖼️ Extension Preview
Prompt Input
Enhanced Prompt
Saved Prompts
---
## 💻 Installation & 🔗 API Integration
1. Download or clone this repository to your local machine
2. Update the `openrouter_secrets.js` file in the extension root with your [OpenRouter API key](https://openrouter.ai/settings/keys):
```js
window.OPENROUTER_API_KEY = 'sk-...'; // Your OpenRouter API key
```
(This file should be gitignored and never shared.)
4. Open Chrome and navigate to `chrome://extensions/`
5. Enable **Developer mode** in the top right corner
6. Click **Load unpacked** and select the extension directory
7. The extension icon should appear in your Chrome toolbar
**Optional:** Run a different model of choice
1. Choose your own [Model](https://openrouter.ai/models?max_price=0) from the free models available on OpenRouter.
2. Copy the model name and replace it in the `popup.js` file.
```
Other free `$models` to choose from:
mistralai/mistral-7b-instruct:free
meta-llama/llama-3.3-8b-instruct:free
meta-llama/llama-4-maverick:free
microsoft/phi-4-reasoning:free
nvidia/llama-3.1-nemotron-ultra-253b-v1:free
```
3. Reload the extension in Chrome.
---
## 👀 Usage
### Basic Usage
1. Click the **Extension Icon** to open the popup
2. Enter your **Raw prompt** in the text area
3. Click **Enhance Prompt** to generate an improved version
4. Use **Save Enhanced Prompt** to store the enhanced prompt for later use
5. Use **Copy to Clipboard** to copy only the enhanced prompt to be used on ChatBots like ChatGPT, Claude, Google Bard and more
6. Saved prompts appear under **Saved Prompts** for easy reuse
### Prompt Library
- Saved prompts are shown in the popup under **Saved Prompts**
- Click any saved prompt to load it into the input area
- Edit and enhance as needed
- Prompts are stored locally and are not used for anything else
---
## ⚙ Workflow
```mermaid
flowchart TD
A["User opens extension popup"] L_A_B_0@--> B["User enters prompt in textarea"]
B L_B_C_0@--> C@{ label: "Clicks 'Enhance Prompt'" }
C L_C_D_0@--> D["Extension sends API request to OpenRouter"]
D L_D_E_0@--> E["OpenRouter LLM returns enhanced prompt"]
E L_E_F_0@--> F["Extension displays enhanced prompt in UI"]
F L_F_G_0@--> G["User can Copy or Save Enhanced Prompt"]
G L_G_H_0@--> H@{ label: "Saved prompts appear in 'Saved Prompts' list" } & I["User pastes enhanced prompt into any AI chatbot"]
H L_H_J_0@--> J["Personalise the Prompt"]
J L_J_B_0@--> B
C@{ shape: rect}
H@{ shape: rect}
L_A_B_0@{ animation: slow }
L_B_C_0@{ animation: slow }
L_C_D_0@{ animation: slow }
L_D_E_0@{ animation: slow }
L_E_F_0@{ animation: slow }
L_F_G_0@{ animation: slow }
L_G_H_0@{ animation: slow }
L_G_I_0@{ animation: slow }
L_H_J_0@{ animation: slow }
L_J_B_0@{ animation: slow }
```
---
## 🛠 Development
### Project Structure
```
/prompt-polish-local-extension/
│
├── manifest.json # Extension metadata
├── background.js # Background tasks and context menu
├── content.js # Context menu and input integration
├── popup.html # Main popup interface
├── popup.js # Popup logic
├── style.css # Shared styles for the popup
├── content.css # Content script styles (scoped, prevents style leakage)
├── openrouter_secrets.js # (Not committed) OpenRouter API key
├── preview # UI Preview
└── icons/ # Extension icons
```
### Local Development
1. Make changes to the source files
2. Go to `chrome://extensions/`
3. Click the refresh icon on the extension card
4. Test your changes
### Testing
- Test the extension on [Postman](https://www.postman.com/) by importing the cURL.
```curl
curl https://openrouter.ai/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-d '{
"model": "$model",
"messages": [
{
"role": "system",
"content": "You are a professional Prompt Engineer........[entire system prompt]."
},
{
"role": "user",
"content": "What is the meaning of life?"
}
]
}'
```
- Try using different prompts for `user` role and `model`
- Verify all features work with your API key in `openrouter_secrets.js`
- Check that enhanced prompts are properly saved and retrieved
---
## 👮🏻♂️ Security
- No data is sent to external servers (except when using OpenRouter API)
- All prompts are stored locally in your browser
- API keys are stored only in your local `openrouter_secrets.js` file
- No tracking or analytics
---
## 🙄 Limitations
- Works only in Chrome/Chromium-based browsers
- Requires manual installation (not available in Chrome Web Store)
- An OpenRouter API key is required for all enhancement features
- If you disable or delete the extension, the saved Prompts are lost
---
## 👨👨👧👦 Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request
---
## 😉 Acknowledgments
- Inspired by the original Paid [Prompt Perfect chrome extension](https://chromewebstore.google.com/detail/prompt-perfect-ai-prompt/kigfbkddbfgbdbdekajodpggpkpfdjfp)
- Built with vanilla JavaScript for maximum compatibility
- Uses Chrome Extension Manifest V3
- Implements modern web standards and best practices
---
**Made with ❤️ by [Brian Castelino](https://github.com/bcastelino)**