Skip to content

AI-powered replies that feel human.Generate natural,context-aware responses on X/Twitter using Gemini API & OpenRouter–fast & smart

License

Notifications You must be signed in to change notification settings

xPOURY4/X-Auto-Reply-Assistant

Repository files navigation

🤖 X Auto Reply Assistant

Chrome Web Store Version License

🚀 Generate natural, context-aware replies that feel authentically human on X/Twitter!

🆕 What's New in v3.0.1

🛡️ Rate Limit Warning System

  • ⚠️ Smart reply tracking to protect your account from Twitter/X restrictions
  • 🕐 Automatic monitoring of replies within a rolling 10-minute window
  • 🚨 Proactive warning modal when exceeding safe reply limits (5 replies per 10 minutes)
  • 🔒 Local storage-based tracking for complete privacy
  • ✨ "Don't show again" option for experienced users
  • 🎨 Beautiful neumorphic modal design matching the extension's aesthetic

🎨 Custom Prompt Feature

  • ✍️ Define your own system prompts with up to 2000 characters
  • 🎭 Full control over AI response personality and style
  • 😊 Toggle formatting options: Emojis, Exclamation marks, Question marks
  • 🎯 Combine custom prompts with preset tones for ultimate flexibility
  • 💾 Persistent storage with validation and real-time character counter
  • 🔄 Easy reset to default prompts anytime

🔐 Enhanced Privacy & Safety

  • 🛡️ Account protection through intelligent rate limiting
  • 📊 All tracking data stored locally, never transmitted
  • ⚡ Negligible performance impact (<5% overhead)
  • 🚫 No personal information collected or stored

🎯 User Experience Improvements

  • 🌟 Intuitive warning system with clear messaging
  • ⌨️ Enhanced keyboard navigation and accessibility
  • 🎨 Color-coded character counter (grey/orange/red) for custom prompts
  • 🔄 Seamless integration with existing features

✨ Features

🧠 Smart AI Integration

  • 🔥 Powered by Gemini API & OpenRouter
  • 🎯 Context-aware response generation
  • 🤖 Multiple AI model support
  • 🛠️ Custom Model Support - Use any OpenRouter model (e.g., x-ai/grok-4-fast:free, anthropic/claude-sonnet-4.5)

Lightning Fast Performance

  • 🚀 Generate replies in seconds
  • 💨 Seamless Twitter integration
  • 🔄 Real-time response generation

🎭 Customizable Tones & Prompts

  • 💼 Professional - For business interactions
  • 😊 Casual - For friendly conversations
  • 🤝 Friendly - For warm engagement
  • 😄 Witty - For humorous responses
  • ✍️ Custom Prompts - Define your own system prompts (up to 2000 characters)
  • 🎨 Formatting Control - Toggle emojis, exclamations, and questions
  • 🔄 Flexible Combinations - Mix custom prompts with preset tones

🌐 Platform Support

  • 🐦 X/Twitter - Full support for twitter.com and x.com
  • 💼 X Pro - Complete compatibility with pro.x.com
  • 🔄 Seamless cross-platform functionality

🛡️ Privacy & Security

  • 🔐 API keys stored locally
  • 🚫 No data collection
  • 🛡️ Privacy-first design
  • 🔒 Secure local storage
  • ⚠️ Rate Limit Protection - Smart tracking to prevent account restrictions
  • 🕐 10-Minute Window Monitoring - Tracks replies to keep you within safe limits
  • 🚨 Proactive Warnings - Alerts before exceeding Twitter/X guidelines

📥 Installation

🌟 From Chrome Web Store (Recommended)

  1. 🔗 Download from Chrome Web Store
  2. 📌 Click "Add to Chrome"
  3. ✅ Confirm installation
  4. 🎉 Start generating amazing replies!

🚀 Quick Start Guide

1️⃣ Setup API Keys

  • 🔑 Click the extension icon in your toolbar
  • ⚙️ Go to Settings tab
  • 🔐 Add your Gemini API or OpenRouter key
  • 🛠️ For OpenRouter: Choose a model or select "Custom Model" to enter your preferred model name
  • 💾 Save your preferences

2️⃣ Generate Your First Reply

  • 🐦 Navigate to X/Twitter
  • 📝 Find a tweet you want to reply to
  • 🎯 Click the "Generate Reply" button
  • 🎭 Choose your desired tone
  • ⚡ Watch the magic happen!

3️⃣ Customize & Post

  • ✏️ Edit the generated reply if needed
  • 📤 Post directly or copy to clipboard
  • 🎉 Engage with authentic, AI-powered responses!

🎯 Perfect For

  • 💼 Business Professionals managing social media presence safely within limits
  • 📱 Content Creators engaging authentically with custom-branded responses
  • 🤝 Community Managers handling high-volume support without account risks
  • 👥 Social Media Enthusiasts wanting better engagement with personalized AI
  • 🚀 Power Users who need custom prompts and advanced formatting control
  • 🛡️ Safety-Conscious Users who want to avoid Twitter/X restrictions
  • 🎨 Brand Managers requiring consistent tone and messaging

🔧 Configuration

🤖 Supported AI Providers

🟢 Gemini API

  • 🆓 Free tier available
  • 🚀 Fast response times
  • 🎯 Excellent context understanding

🔵 OpenRouter

  • 🌐 Multiple model access with 4 curated free models
  • 💪 Advanced AI capabilities from leading providers
  • 🔄 Easy model switching through dropdown selection
  • 🛠️ Custom Model Support - Enter any model name for specialized use cases
  • 🆓 Free Models Included: deepseek/deepseek-chat-v3.1:free, openai/gpt-oss-20b:free, qwen/qwen3-coder:free, moonshotai/kimi-k2:free

🟡 OpenAI

  • 🚀 Latest GPT models including GPT-4o, GPT-4-turbo, GPT-3.5-turbo
  • 🎯 High-quality responses with excellent context understanding
  • 🔧 Custom model support for specialized applications

🟣 DeepSeek

  • 🧠 Specialized in reasoning and coding tasks
  • ⚡ Fast response times with deepseek-chat and deepseek-reasoner models
  • 🎯 Optimized for technical and analytical responses

🔵 Anthropic Claude

  • 🤖 Claude Sonnet 4.5, Claude Opus 4.1, and other advanced models
  • 🎭 Excellent for nuanced and contextual conversations
  • 🛡️ Strong safety and alignment features

⚙️ Settings Options

  • 🎭 Default tone selection
  • 📝 Custom default text
  • 🔑 API key management
  • 🎨 Response customization
  • 🛠️ Custom Model Configuration - Select "Custom Model" from OpenRouter dropdown and enter your preferred model name
  • ✍️ Custom Prompt System - Define your own AI instructions and formatting preferences
  • 🛡️ Rate Limit Protection - Automatic tracking with configurable warnings

📊 How It Works

graph LR
    A[🐦 Select Tweet] --> B[🎯 Choose Tone]
    B --> C[🤖 AI Processing]
    C --> D[⚡ Generate Reply]
    D --> E[✏️ Edit & Post]
Loading
  1. 📝 Tweet Selection - Choose any tweet to reply to
  2. 🎭 Tone Selection - Pick the perfect response style
  3. 🤖 AI Processing - Advanced context analysis
  4. Reply Generation - Natural, human-like responses
  5. 📤 Post & Engage - Share your authentic reply

🛡️ Privacy & Security

  • 🔐 Local Storage Only - API keys never leave your device
  • 🚫 No Data Collection - We don't track or store your data
  • 🛡️ Privacy First - Your conversations stay private
  • 🔒 Secure Processing - All operations happen locally
  • ⚠️ Rate Limit Protection - Local tracking to prevent account restrictions
  • 📊 Anonymous Tracking - Only timestamps and tweet URLs stored locally
  • 🛡️ Account Safety - Proactive warnings before exceeding Twitter/X limits

🤝 Contributing

We welcome contributions! 🎉

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch
  3. 💻 Make your changes
  4. 🧪 Test thoroughly
  5. 📤 Submit a pull request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

📋 Version History

v3.0.1 (October 28, 2025)

  • ✨ Added Rate Limit Warning System for account protection
  • 🎨 Introduced Custom Prompt feature with formatting controls
  • 🛡️ Enhanced privacy and safety features
  • 📊 Minimal performance impact (<5% overhead)
  • 🔄 Non-breaking update - fully backward compatible

v2.7.0 & Earlier

🆘 Support

📚 Documentation

For detailed information about new features:

  • Rate Limit System: See CHANGELOG_3.0.1.md for complete rate limit documentation
  • Custom Prompts: Refer to custom prompt feature guides for setup and usage
  • Quick Testing: Use provided test guides to verify functionality
  • Troubleshooting: Check feature-specific README files for common issues

🌟 Show Your Support

If you find this extension helpful:

  • ⭐ Star this repository
  • 🔄 Share with friends
  • 📝 Leave a review on Chrome Web Store
  • 🐦 Tweet about it!

🚀 Transform your Twitter engagement safely with AI-powered customization! 🌟

✨ v3.0.1 Features:

  • 🛡️ Rate Limit Protection - Stay safe from account restrictions
  • ✍️ Custom Prompts - Your brand, your voice, your way
  • 🎨 Advanced Formatting - Full control over AI responses

Download Now

Made with ❤️ for the Twitter community | Protecting your account since v3.0.1

About

AI-powered replies that feel human.Generate natural,context-aware responses on X/Twitter using Gemini API & OpenRouter–fast & smart

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published