An open API service indexing awesome lists of open source software.

https://github.com/supratimrk/ai-rewrite

Chrome extension โœจ Right-click selected text in input fields to rewrite it (Polite, Professional, Cheeky, etc.) or compose new text using Google Gemini AI ๐Ÿค–. Because sometimes words are hard. ๐Ÿคทโ€โ™€๏ธ
https://github.com/supratimrk/ai-rewrite

ai ai-api api chrome-extension chrome-extensions content-creation context-menu gemini gemini-api gemini-api-js javascript natural-language-processing nlp productivity productivity-tools text-rewriter

Last synced: about 2 months ago
JSON representation

Chrome extension โœจ Right-click selected text in input fields to rewrite it (Polite, Professional, Cheeky, etc.) or compose new text using Google Gemini AI ๐Ÿค–. Because sometimes words are hard. ๐Ÿคทโ€โ™€๏ธ

Awesome Lists containing this project

README

          


Screenshot

# โœจ AI Text Rewriter Pro - Advanced Chrome Extension for AI-Powered Writing โœจ

**(Transform your writing with OpenAI and OpenAI-compatible APIs! ๐Ÿš€)**

[![Version](https://img.shields.io/badge/Version-2.5.1-blue)](https://github.com/SupratimRK/Ai-rewrite/releases) [![License](https://img.shields.io/badge/License-MIT-green)](LICENSE) [![Chrome Extension](https://img.shields.io/badge/Chrome-Extension-yellow)](https://chrome.google.com/webstore) [![AI Powered](https://img.shields.io/badge/AI-OpenAI-red)](https://platform.openai.com/) [![JavaScript](https://img.shields.io/badge/Language-JavaScript-blue)](https://developer.mozilla.org/en-US/docs/Web/JavaScript) [![GitHub Stars](https://img.shields.io/github/stars/SupratimRK/Ai-rewrite?style=social)](https://github.com/SupratimRK/Ai-rewrite/stargazers) [![GitHub Forks](https://img.shields.io/github/forks/SupratimRK/Ai-rewrite?style=social)](https://github.com/SupratimRK/Ai-rewrite/network/members) [![GitHub Issues](https://img.shields.io/github/issues/SupratimRK/Ai-rewrite)](https://github.com/SupratimRK/Ai-rewrite/issues) [![Validation](https://github.com/SupratimRK/Ai-rewrite/actions/workflows/validate.yml/badge.svg)](https://github.com/SupratimRK/Ai-rewrite/actions/workflows/validate.yml)

**AI Text Rewriter Pro** is a powerful Chrome extension that revolutionizes your writing using OpenAI and OpenAI-compatible APIs. Perfect for content creators, professionals, students, and anyone who wants to enhance their writing with AI assistance. Features **21+ built-in rewriting modes**, **custom prompts**, **grammar checking**, **undo functionality**, and seamless integration across all websites.

## ๐ŸŽฏ Quick Start Guide

1. **Install**: [Download from Chrome Web Store](https://chrome.google.com/webstore) (coming soon) or load unpacked
2. **Setup**: Add your OpenAI API key in extension settings (or use OpenAI-compatible API endpoint)
3. **Use**: Select text on any website โ†’ Right-click โ†’ Choose AI rewriting mode
4. **Enjoy**: Watch your writing transform with professional AI assistance!

## ๐Ÿ” Keywords & Search Terms

**Chrome Extension AI Writing Tools** | **OpenAI Text Rewriter** | **AI Grammar Checker** | **Professional Writing Assistant** | **Content Creation Tools** | **Text Improvement Software** | **AI-Powered Editor** | **Writing Enhancement Extension** | **Productivity Tools for Writers** | **Automated Content Editing**

---

Ever stared at a sentence you wrote and thought, "Wow, I sound like a bored robot trying to order pizza"? ๐Ÿค–๐Ÿ• This extension is your secret weapon! It uses **OpenAI** (GPT-4o, GPT-4o-mini, or any OpenAI-compatible API like LM Studio, Ollama, etc.) to magically rewrite your text directly in input fields and text areas across the web.

Select some text, right-click, pick a vibe, and BAM! ๐Ÿ’ฅ New words. Hopefully better words. Sometimes... *interesting* words. It's AI, folks, it's a wild ride! ๐ŸŽข

---

## ๐Ÿš€ What's New in Version 2.5.1! ๐Ÿš€

- ๏ฟฝ **Fixed Preview Mode** - Text injection now works reliably when clicking "Insert"
- โœจ **Improved Highlighting** - Input/textarea fields now get a golden outline highlight
- ๏ฟฝ๐Ÿ”„ **OpenAI Integration** - Uses OpenAI instead of Google Gemini (since v2.5.0)
- ๐ŸŒ **Custom API Endpoints** - Support for OpenAI-compatible APIs (LM Studio, Ollama, etc.)
- ๐ŸŽญ **21 Professional Writing Modes** - From humanize to technical precision
- ๐ŸŽจ **Custom Mode Creator** - Build your own rewriting styles
- โ†ถ **Undo Functionality** - Instantly revert any rewrite
- โŒจ๏ธ **Keyboard Shortcuts** - Lightning-fast rewriting with hotkeys
- ๐Ÿ“Š **Usage Analytics** - Track your writing improvements
- ๐ŸŒ™ **Dark Mode** - Easy on the eyes, beautiful interface
- ๐Ÿ”„ **Multiple AI Models** - Choose from GPT-4o, GPT-4o-mini, or GPT-3.5-turbo
- ๐Ÿ“ค **Settings Export/Import** - Backup and share your configurations
- ๐Ÿ›ก๏ธ **Enhanced Error Handling** - Robust retry logic and user-friendly messages
- ๐ŸŽฏ **Smart Text Validation** - Length limits and content filtering

---

## ๐Ÿš€ Features (The Shiny Bits!) ๐Ÿš€

* **๐Ÿช„ Magic Wand Right-Click Action:** Select text in almost any editable field, right-click, and BOOM - rewrite options appear!
* **๐ŸŽญ 21 Professional Writing Modes:** From humanize to technical precision, empathetic to persuasive - we've got every tone covered!
* **๐ŸŽจ Custom Mode Creator:** Build your own rewriting styles with personalized prompts
* **โ†ถ Undo Functionality:** Instantly revert any rewrite with a single click
* **โŒจ๏ธ Keyboard Shortcuts:** Lightning-fast rewriting with customizable hotkeys
* **๐Ÿง  Powered by OpenAI:** Use GPT-4o, GPT-4o-mini, GPT-3.5-turbo, or any OpenAI-compatible API
* **๐ŸŒ Flexible API Support:** Works with OpenAI, LM Studio, Ollama, and other compatible endpoints
* **๐Ÿ”‘ Secure API Key Storage:** Uses `chrome.storage.sync` to save your API key (syncs across your Chrome browsers!)
* **๐ŸŽจ Modern Options Interface:** Dark mode support and intuitive settings management
* **๐Ÿ“Š Usage Analytics:** Track your writing improvements and most-used modes
* **๐Ÿ“ข Smart Notifications:** Helpful popups that tell you what's happening (and fade away gracefully)
* **๐Ÿ›ก๏ธ **Enhanced Error Handling:** Robust retry logic and user-friendly error messages

---

## ๐ŸŽญ 17 Built-in Writing Modes

| Mode | Purpose | Perfect For |
|------|---------|-------------|
| ๐Ÿ“ **Humanize** | Make text sound natural and conversational | Robot-like content, stiff writing |
| โœ… **Grammar Fix** | Correct spelling and grammar only | Quick proofreading, error correction |
| ๐Ÿ‘” **Professional** | Business-appropriate formal tone | Emails, reports, official documents |
| ๐Ÿ™ **Polite** | Courteous and respectful language | Customer service, delicate situations |
| ๐Ÿ˜Š **Casual** | Friendly, informal conversation | Social media, casual emails |
| ๐Ÿ’ช **Confident** | Assertive and decisive language | Presentations, negotiations |
| โค๏ธ **Empathetic** | Understanding and caring tone | Support messages, sensitive topics |
| ๐ŸŽฏ **Persuasive** | Compelling and convincing | Sales copy, proposals, arguments |
| โšก **Concise** | Clear and to-the-point | Headlines, summaries, tweets |
| ๐Ÿ“š **Detailed** | Comprehensive and thorough | Explanations, tutorials, guides |
| ๐ŸŽจ **Creative** | Engaging and imaginative | Marketing copy, storytelling |
| ๐Ÿ”ฌ **Technical** | Precise and specification-focused | Documentation, instructions |
| ๐Ÿ˜ **Cheeky** | Playful and slightly sarcastic | Social media, casual content |
| ๐ŸŽ“ **Beginner-Friendly** | Simple and accessible language | Educational content, how-tos |
| โœ๏ธ **Composer** | Generate content from instructions | Create new text from prompts |
| ๐ŸŒ **Translate** | Convert to English or improve clarity | International content, clarity |
| ๐Ÿ“„ **Summarize** | Extract key points concisely | Long documents, research |

---

## ๐Ÿ› ๏ธ Installation & Quick Start Guide ๐Ÿ› ๏ธ

### ๐Ÿ“ฆ Installation (Let's Get This Party Started!)

Alright, since this isn't (yet?) on the Chrome Web Store (because who has time for reviews? ๐Ÿ™„), you gotta load it manually like a true tech wizard (or someone who can follow instructions).

1. **Grab the Goods ๐Ÿ›๏ธ:** Download the extension files. Either clone the repository or download the ZIP and unzip it somewhere you won't accidentally delete it later. Let's call this magical place the `ai-rewriter-extension` folder.
2. **Open Chrome's Secret Lair ๐Ÿšช:** Open Google Chrome, type `chrome://extensions` in your address bar, and hit Enter. Spooooky!
3. **Flip the Super Secret Developer Switch ๐Ÿ•ต๏ธโ€โ™€๏ธ:** Look for a toggle labeled "Developer mode" (usually in the top right corner). Click it. If it's on, you're basically a hacker now. Congrats.
4. **Shove the Folder at Chrome ์šฑ:** Click the "Load unpacked" button that magically appeared. A file browser window will pop up.
5. **Point and Shoot ๐Ÿ‘‰:** Navigate to and select that `ai-rewriter-extension` folder (the one *containing* the `manifest.json` file, not the zip file!). Click "Select Folder" or "Open".
6. **Bask in the Glory (or fix errors) ๐Ÿ™:** If all went well, you should see the "AI Text Rewriter Pro" extension card appear on the page! If you see angry red errors, you probably messed up step 5. Go back and try again, champ. ๐Ÿ’ช
7. **Pin for Easy Access:** Click the puzzle piece icon in Chrome's toolbar and pin the AI Text Rewriter Pro extension for quick access.

๐ŸŽ‰ **Ta-da!** The extension icon should appear in your Chrome toolbar!

### ๐Ÿš€ Quick Start Guide

#### 1. Initial Setup
1. Click the extension icon or right-click โ†’ "Settings"
2. Get your API key from [OpenAI Platform](https://platform.openai.com/api-keys)
3. (Optional) Add custom base URL for OpenAI-compatible APIs
4. Paste your API key and test the connection
5. Customize your settings (models, modes, shortcuts)
6. Save and start rewriting!

#### 2. Using the Extension
**Right-Click Method:**
1. Select text in any editable field
2. Right-click on the selected text
3. Choose "โœจ Rewrite with AI" โ†’ pick your desired mode
4. Watch the magic happen!

**Keyboard Shortcuts:**
- `Ctrl+Shift+H` - Humanize selected text
- `Ctrl+Shift+P` - Professional tone
- `Ctrl+Shift+Z` - Undo last rewrite

---

## โš™๏ธ Configuration: The Golden Ticket ๐Ÿ”‘

Okay, here's the *slightly* annoying part. This extension needs **YOUR** OpenAI API Key to actually talk to the AI. Think of it like needing a password to get into the cool AI club.

**Why?** Because accessing powerful AI models costs money (or at least has usage limits), and OpenAI needs to know who's asking! This extension makes requests directly from *your* browser using *your* key.

**Where to Snag This Magical Key? ๐Ÿค”**

1. Go to the **[OpenAI Platform](https://platform.openai.com/api-keys)**. You'll need an OpenAI account.
2. Click "Create new secret key" or "+Create new secret key".
3. Give your key a name (like "AI Rewriter Extension").
4. **COPY THIS KEY!** ๐Ÿ“‹ It starts with `sk-` and is a long string of random characters. Treat it like a password. Don't share it publicly!
5. **Important:** You won't be able to see this key again, so save it somewhere safe!

**Alternative: OpenAI-Compatible APIs**

You can also use other compatible APIs:
- **Vercel AI Gateway**: Unified access to multiple AI providers - set base URL to `https://ai-gateway.vercel.sh/v1`
- Get your API key from [Vercel Dashboard](https://vercel.com/dashboard)
- Use models in `provider/model` format (e.g., `meta/llama-3.1-8b`, `anthropic/claude-sonnet-4.5`)
- Access OpenAI, Anthropic, Meta, Google, Amazon, and more through one endpoint!
- **LM Studio**: Run models locally - set base URL to `http://localhost:1234/v1`
- **Ollama**: Local models - typically `http://localhost:11434/v1`
- **Any OpenAI-compatible endpoint**: Just set the custom base URL in settings

**Plugging in the Power Cord ๐Ÿ”Œ**

1. Click the **AI Text Rewriter Pro extension icon** ๐Ÿงฉ in your Chrome toolbar. This should open the modern Options page.
* *Alternatively:* Go back to `chrome://extensions`, find the AI Text Rewriter Pro card, click "Details", then "Extension options". So many clicks!
2. You'll see a field labeled "**OpenAI API Key**". It's a password field, so you won't see the key as you paste (oooooh, security! โœจ).
3. **PASTE** your copied API key into this box.
4. (Optional) If using a compatible API, enter the base URL in the "Custom Base URL" field.
5. Click "**Test API Key**" to verify your connection works. ๐Ÿงช
6. Click the glorious "**Save Settings**" button. ๐Ÿ’พ
7. You *should* see a happy green message saying "Settings saved successfully!". โœ… If you see an angry red message, well... Houston, we have a problem. ๐Ÿš€ (Did you paste the *whole* key?).

**โ— IMPORTANT NOTE ABOUT YOUR KEY โ—**

* **Keep it Secret, Keep it Safe!** ๐Ÿ”’ Don't commit it to public code, don't paste it in random chat rooms. It's linked to *your* OpenAI account.
* **Usage Costs $$$!** OpenAI charges for API usage based on tokens. Check their [pricing page](https://openai.com/api/pricing/)! You are responsible for the usage associated with your key. Start with GPT-4o-mini for cost-effective rewrites. Don't blame us if you rewrite War and Peace and get a bill. ๐Ÿ’ธ
* **Free Alternative:** Use local models with LM Studio or Ollama for completely free, private AI rewriting!

---

## โœจ How to Use (The Fun Part!) โœจ

Okay, installed? โœ… API key saved? โœ… Ready to rock? โœ… Let's rewrite!

1. **Find a Victim... I Mean, a Text Box ๐ŸŽฏ:** Go to any website with a text input field (``, some `` fields). Think email drafts, comment boxes, social media posts, online notepads... you get the idea.
* **Heads Up:** This probably *won't* work on super fancy custom editors like Google Docs or Notion directly, as they do weird things. It *definitely* won't work on `chrome://` pages (like the extensions page itself) for security reasons! Stick to normal web pages (http/https).
2. **Type Your Soon-to-be-Glorious Words โŒจ๏ธ:** Write something. Anything! Pour your heart out, or just type "the quick brown fox jumps over the lazy dog".
3. **Highlight the Chosen Ones โœจ:** Select the text you want to transform using your mouse or keyboard.
4. **Invoke the Menu! Right-Click Pow! ๐Ÿ–ฑ๏ธ๐Ÿ’ฅ:** Right-click directly *on the selected text*.
5. **Behold! The Menu! ๐Ÿคฉ:** Hover over the "**โœจ Rewrite with AI**" option in the context menu that pops up.
6. **Pick Your Mode ๐ŸŽญ:** Choose one of the 17 available modes from the sub-menu (Humanize, Professional, Creative, Technical, etc.).
7. **Patience, Grasshopper... ๐ŸŒฑ:** A sleek notification will appear showing the progress. The extension sends your text and chosen mode to the selected Gemini AI model. Response time depends on text complexity and your selected AI model. ๐Ÿน
8. **Witness the Transformation! ๐Ÿช„:** If the AI gods smile upon you, the selected text will be **replaced** with the rewritten version! ๐ŸŽ‰

---

## โš™๏ธ Advanced Features

### ๐ŸŽจ Custom Modes
Create your own rewriting styles:
1. Go to Settings โ†’ Custom tab
2. Enter a name and detailed prompt
3. Save and use it like any built-in mode
4. Export/import custom modes between devices

### ๐Ÿ“Š Usage Analytics
Track your writing improvements:
- Total rewrites performed
- Characters processed
- Most-used modes
- Usage timeline

### ๐Ÿ›ก๏ธ Smart Protection
- **Rate Limiting**: Prevents API overuse
- **Text Length Limits**: Configurable maximum text size
- **Error Recovery**: Automatic retries with exponential backoff
- **Safety Filters**: Content moderation built-in

### ๐Ÿ”ง Advanced Settings
- **Multiple AI Models**: Choose between Gemini 1.5 Flash, Pro, or 2.0
- **Dark Mode**: Beautiful dark interface
- **Keyboard Shortcuts**: Customizable hotkeys
- **Undo History**: Keep track of recent changes
- **Settings Backup**: Export/import all configurations

---

## ๐Ÿšจ Enhanced Error Handling & User Notifications

Version 2.1.1 introduces comprehensive error handling to keep you informed every step of the way:

### ๐Ÿ”ง Automatic Error Detection
- **API Key Validation**: Instant feedback on missing or invalid API keys
- **Network Error Handling**: Clear messages for connection issues
- **Rate Limit Detection**: Helpful notifications when API limits are reached
- **Content Safety Filters**: Informative messages about blocked content

### ๐Ÿ“ข Smart Notification System
- **Clickable Error Messages**: Click on API key errors to open settings directly
- **System Notifications**: Native Chrome notifications for setup reminders
- **Progressive Error Messages**: Context-aware help based on error type
- **Auto-Recovery**: Intelligent retry logic for temporary issues

### ๐ŸŽฏ Common Error Solutions

| Error Type | What It Means | How to Fix |
|------------|---------------|------------|
| ๐Ÿ”‘ **"No API key configured"** | Missing OpenAI API key | Click notification to open settings |
| ๐Ÿšซ **"Invalid API key format"** | Incorrect key format | Check your key starts with "sk-" or "sess-" |
| โšก **"Rate limit reached"** | Too many requests | Wait a few minutes or upgrade your OpenAI plan |
| ๐ŸŒ **"Network error"** | Connection issues | Check your internet connection or base URL |
| ๐Ÿ›ก๏ธ **"Content blocked"** | Safety filters triggered | Try rephrasing your text |
| โฐ **"Request timeout"** | Server response delay | Try again with shorter text |

---

## ๐ŸŽฏ Perfect For

- **Content Creators** - Adapt tone for different audiences
- **Business Professionals** - Polish emails and documents
- **Students** - Improve academic writing
- **Customer Service** - Craft appropriate responses
- **Social Media Managers** - Match brand voice
- **Non-native Speakers** - Enhance English fluency
- **Marketers** - Create compelling copy
- **Technical Writers** - Clarify complex concepts

---

## ๐ŸŽญ Detailed Mode Guide (Choose Your Weapon Wisely) ๐ŸŽญ

### Core Writing Modes

* **๐Ÿ“ `Humanize`:** Make text sound natural and conversational ๐Ÿค–โžก๏ธ๐Ÿง‘โ€๐ŸŽจ
* *Perfect for:* Robot-like content, stiff writing, overly formal text that needs a conversational flow.

* **โœ… `Grammar Fix`:** Your personal proofreader ๐Ÿง
* *Perfect for:* Quick error correction without changing tone or meaning. Focuses purely on spelling and grammar.

* **๐Ÿ‘” `Professional`:** Business-appropriate formal tone ๏ฟฝ
* *Perfect for:* Work emails, reports, official documents, presentations, and corporate communication.

* **๐Ÿ™ `Polite`:** Courteous and respectful language
* *Perfect for:* Customer service, delicate situations, requests, and when you need to sound diplomatic.

### Personality & Tone Modes

* **๐Ÿ˜Š `Casual`:** Friendly, informal conversation
* *Perfect for:* Social media posts, casual emails, friendly messages, and relaxed communication.

* **๐Ÿ’ช `Confident`:** Assertive and decisive language
* *Perfect for:* Presentations, negotiations, leadership communication, and when you need to sound authoritative.

* **โค๏ธ `Empathetic`:** Understanding and caring tone
* *Perfect for:* Support messages, sensitive topics, consoling someone, and emotional communication.

* **๐Ÿ˜ `Cheeky`:** Playful and slightly sarcastic
* *Perfect for:* Social media content, casual writing, humor, and when you want to add personality.

### Content Optimization Modes

* **๐ŸŽฏ `Persuasive`:** Compelling and convincing language
* *Perfect for:* Sales copy, proposals, arguments, marketing content, and calls-to-action.

* **โšก `Concise`:** Clear and to-the-point
* *Perfect for:* Headlines, summaries, tweets, bullet points, and when brevity matters.

* **๐Ÿ“š `Detailed`:** Comprehensive and thorough
* *Perfect for:* Explanations, tutorials, guides, documentation, and in-depth content.

* **๐ŸŽจ `Creative`:** Engaging and imaginative
* *Perfect for:* Marketing copy, storytelling, creative writing, and content that needs flair.

### Specialized Modes

* **๐Ÿ”ฌ `Technical`:** Precise and specification-focused
* *Perfect for:* Documentation, instructions, technical writing, and professional specifications.

* **๐ŸŽ“ `Beginner-Friendly`:** Simple and accessible language
* *Perfect for:* Educational content, how-to guides, explaining complex topics simply.

* **โœ๏ธ `Composer`:** Generate content from instructions ๐Ÿงž
* *Perfect for:* Creating new text from prompts. Type your instruction (e.g., "write email asking for project update"), select it, and choose Composer to generate fresh content.

* **๐ŸŒ `Translate`:** Convert to English or improve clarity
* *Perfect for:* International content, non-native English text, and improving readability.

* **๐Ÿ“„ `Summarize`:** Extract key points concisely
* *Perfect for:* Long documents, research papers, articles, and when you need the main points.

---

## ๐Ÿค” Troubleshooting (When Things Go Sideways) ๐Ÿค”

Yeah, sometimes technology just says "NOPE". ๐Ÿ™…โ€โ™‚๏ธ Here's a comprehensive guide:

### Common Issues

**๐Ÿ˜ญ It's Not Working AT ALL!**
* **API Key:** Did you *actually* save your API key correctly in the options? Is it the *right* key? Double-check!
* **Reload Extension:** Go to `chrome://extensions` and click the little refresh icon ๐Ÿ”„ on the AI Text Rewriter Pro card. Sometimes extensions get sleepy.
* **Reload Page:** Try refreshing the webpage (F5) you're trying to use it on.
* **Check Console (Background):** Go to `chrome://extensions`, find the AI Text Rewriter Pro card, and click the "**Service worker**" link. Look for **RED ERROR MESSAGES** in the console window that pops up *after* you try to use the extension. Copy/paste these if you need help!
* **Check Console (Page):** On the webpage where it's failing, right-click anywhere, select "Inspect", and go to the "Console" tab. Try using the extension again. Any **RED ERRORS** there?

**"API Key not working"**
- Verify key is correctly copied from the AI provider
- Check if your account has API access enabled
- Test connection in Settings โ†’ General โ†’ Test API Key

**๐Ÿšซ Error: `Cannot access chrome:// URL`**
* You're trying to use the extension on a Chrome settings page (like `chrome://extensions`). For security reasons, Chrome blocks extensions from messing with these pages. Use it on a regular `http://` or `https://` website.

**"Cannot rewrite on this page"**
- Extension only works on regular websites (http/https)
- Won't work on Chrome internal pages (chrome://)
- Ensure you're in an editable text field

**"Text not replacing"**
- Click in the text field before selecting text
- Try refreshing the page and attempting again
- Check browser console for detailed error messages

**โœจ Weird Output (Options, Asterisks `*`, Emails when you didn't ask?)**
* The AI can be a bit... creative. We've tried to tell it *very sternly* in the prompts to JUST give the rewritten text and nothing else (no markdown like `*emphasis*`, no "Option 1:", etc.).
* If you still get weird formatting or unexpected content (like a full email for "Professional Tone"), the AI might be ignoring instructions. We added some cleanup code, but it's not perfect. Prompt engineering is hard! ๐Ÿคทโ€โ™‚๏ธ

**๐Ÿšฆ Error: `Content blocked by API...`**
* The AI's safety filters might have flagged your original text or the requested rewrite (especially possible with "Cheeky"). Try rephrasing your original text or using a different mode.

**"Too many requests"**
- Built-in rate limiting prevents API overuse
- Wait 60 seconds and try again
- Consider upgrading your plan for higher limits

**๐Ÿ“‰ API Errors (4xx/5xx Status)**
* `400 Bad Request`: Often means the model name is wrong or the request format is broken. Try switching AI models in settings.
* `401 Unauthorized` / `403 Forbidden`: Almost always an **API Key problem**. Is it correct? Is it enabled? Does your project have the API enabled?
* `404 Not Found`: The API endpoint URL might be wrong.
* `429 Too Many Requests`: You might be hitting rate limits. Slow down!
* `500 Internal Server Error`: The servers are having a hiccup. Try again later. โ˜•

### Getting Help
1. Check the browser console (F12) for detailed error messages
2. Test your API connection in the settings
3. Try different AI models if one isn't working
4. Report issues with specific error messages

---

## ๐Ÿ” Privacy & Security

- **Your API Key**: Stored locally in your browser, never shared
- **Your Text**: Sent directly to the AI provider's servers, not stored by us
- **Usage Data**: Optional analytics stored locally only
- **No External Tracking**: No third-party analytics or tracking
- **Open Source**: Inspect the code to verify privacy practices

---

## ๐Ÿ“ˆ Performance Tips

1. **Choose the Right Model**:
- Gemini 1.5 Flash: Fastest, most cost-effective
- Gemini 1.5 Pro: More capable, better for complex tasks
- Gemini 2.0 Flash: Latest features, experimental

2. **Optimize Text Length**:
- Keep selections under 2000 characters for best speed
- Break long documents into smaller sections
- Use concise mode for lengthy content

3. **Use Custom Modes**:
- Create specific prompts for recurring tasks
- More targeted results than generic modes
- Save time with personalized workflows

---

## ๐Ÿ”ฎ Future Roadmap

- ๐ŸŒ **Multi-language Support** - Rewrite in different languages
- ๐Ÿ”Š **Voice Input** - Dictate text for rewriting
- ๐Ÿ“ฑ **Mobile Support** - Browser extension for mobile
- ๐Ÿค– **AI Model Comparison** - Side-by-side results
- ๐Ÿ“ **Template Library** - Pre-made prompts for common tasks
- ๐Ÿ”— **Integration APIs** - Connect with other writing tools
- ๐Ÿ“Š **Advanced Analytics** - Writing improvement insights

---

## ๐Ÿ’ก Contributing (Got Ideas? Found Bugs?) ๐Ÿ’ก๐Ÿ›

Hey, if you have ideas to make this less buggy or more awesome, or if you found a hilarious bug (like it rewriting everything into pirate speak ๐Ÿดโ€โ˜ ๏ธ - which would be kinda cool, actually), feel free to:

* Open an issue on the GitHub repository (if this *is* on GitHub... otherwise, uh... tell the developer?).
* Fork it, fix it, and submit a pull request (again, GitHub stuff).

We appreciate the help making this thing slightly less likely to explode. ๐Ÿ”ฅ

---

## ๐Ÿ“œ License (The Legal Mumbo Jumbo) ๐Ÿ“œ

This extension is licensed under the **MIT License**.

Basically, this means you can do almost whatever you want with this code (use it, copy it, modify it, sell it - though good luck with that!), as long as you include the original copyright and license notice.

**BUT, there's NO WARRANTY.** If this extension accidentally deletes your masterpiece novel, formats your hard drive, or makes your coffee cold... tough luck. Use at your own risk! ๐Ÿ˜‰

---

## ๐Ÿ“ Acknowledgments & Credits

- **Google Gemini AI** - Powering the intelligence behind every rewrite
- **Chrome Extension APIs** - Making seamless integration possible
- **Open Source Community** - Inspiration and best practices
- **Beta Testers** - Feedback that shaped this extension
- Special thanks to the Gemini, OpenAI and Anthropic team for their amazing AI technology!
- Thanks to the Chrome extension development community for all the resources and inspiration! ๐Ÿ™Œ
- And a big shoutout to you, the user! Thanks for trying out this extension and making the internet a slightly more interesting place! ๐ŸŒโœจ

---

## ๐Ÿ’ Support the Project

Enjoying AI Text Rewriter Pro? Here's how you can help:

1. โญ **Star the repository** (if open source)
2. ๐Ÿ’ฌ **Share with friends** who write content
3. ๐Ÿ› **Report bugs** to help improve the extension
4. ๐Ÿ’ก **Suggest features** for future versions
5. โ˜• **Buy me a chai** (because coffee is overrated!)

---
If you like this extension, consider buying me a coffee! โ˜• (Just kidding, I don't drink coffee. But I appreciate the thought!)

**Transform your writing today with AI Text Rewriter Pro!** โœจ

*Made with ๐Ÿ’™ and lots of โ˜• (actually ๐Ÿซ– chai) by Supratim*

**Happy Rewriting! May your words be ever in your favor!** โœจ