X Crypto Agent - AI-Powered Twitter/X Reply Bot

Generate intelligent, contextual replies on Twitter/X using Google Gemini AI

Features • Installation • API Key Setup • Usage • Configuration

Overview

X Crypto Agent is a Chrome browser extension that uses Google Gemini AI to automatically generate contextually relevant replies on Twitter/X. It's specifically designed for the cryptocurrency community, allowing users to engage more effectively with tweets while maintaining their unique voice and persona.

Features

Core Features

AI-Powered Reply Generation - Generate intelligent, human-like replies with a single click
Smart Language Detection - Automatically detects tweet language and responds in the same language (English tweet = English reply, Turkish tweet = Turkish reply)
Natural Replies - 2 sentences, ~30 words, no abbreviations (ngl, tbh, lfg), no emojis, no exclamation marks
Link Summarization - Analyzes and summarizes links in tweets for better context
Author Style Analysis - Analyzes the author's writing style for more relevant replies

Content Generation

Project Post Generator - Create promotional posts for crypto projects
Viral Post Generator - Generate high-engagement tweet variations
Hashtag Suggester - AI-powered hashtag recommendations
Competitor Analysis - Analyze competitor Twitter accounts

Automation

Auto-Reply to Mentions - Automatically respond to notifications
Auto-Comment - Post replies automatically with configurable delays
Auto-Like - Automatically like the original post when replying
Scheduled Posts - Schedule tweets for future posting

Personalization

Multiple Personas - Choose from Degen, Analyst, Roast, Maxi, Builder, Neutral, or Custom
Investment Philosophy - Add your crypto beliefs to reflect in responses
Writing Style Detection - Analyze and match any user's writing style
Tone Selection - Bullish, Bearish, Funny, Professional, or Casual
Reply Length Control - Short, Medium, or Long responses

Targeting & Analytics

Daily Reply Limits - Control engagement volume
Follower Range Filtering - Target users by follower count
Whitelist/Blacklist - Control who you engage with
Reply Tracking - Visual indicators showing reply status:
- 🟢 Green dot = Replied within last 24 hours
- 🔴 Red dot = Not replied yet or reply older than 24 hours
Analytics Dashboard - View reply statistics, charts, and top accounts

Multi-Language Support

English, Turkish, German, French, Spanish UI
Auto-detect tweet language and reply in the same language

Installation

Method 1: Git Clone (Recommended)

Clone the repository

git clone https://github.com/Bihruze/x-reply.git

Navigate to the project folder
```
cd x-reply
```
Add your API Key (See API Key Setup below)
Load the extension in Chrome
- Open Chrome and go to chrome://extensions/
- Enable Developer mode (toggle in top right corner)
- Click Load unpacked
- Select the x-reply folder
Pin the extension (Optional)
- Click the puzzle icon in Chrome toolbar
- Find "X Crypto Agent" and click the pin icon

Method 2: Download ZIP

Click the green Code button on GitHub
Select Download ZIP
Extract the ZIP file to a folder
Follow steps 3-5 from Method 1

API Key Setup

This extension requires a Google Gemini API Key to function.

Step 1: Get Your API Key

Go to Google AI Studio
Sign in with your Google account
Click Create API Key
Copy the key (it starts with AIzaSy...)

Step 2: Enable Billing (IMPORTANT - To Avoid Daily Limits)

Warning: Without billing enabled, you're limited to 1,500 requests/day. With billing enabled, you get much higher limits and only pay for what you use (very cheap).

Go to Google Cloud Console
Create a billing account or select existing one
Go to Google AI Studio Settings
Link your API key to a billing-enabled project
Set up a budget alert if desired (recommended)

Pricing: Gemini API is very affordable - approximately $0.0001 per request. Even heavy usage rarely exceeds a few dollars per month.

Step 3: Add the API Key to the Extension

Open the x-reply folder
Open service_worker.js in a text editor (VS Code, Notepad++, etc.)

Find line 98:

const API_KEY = ""; // <-- PASTE YOUR API KEY HERE

Paste your API key between the quotes:

const API_KEY = "AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxx"; // <-- PASTE YOUR API KEY HERE

Save the file

Step 4: Reload the Extension

Go to chrome://extensions/
Find "X Crypto Agent"
Click the reload icon (circular arrow)

Usage

Basic Usage

Navigate to Twitter/X - Go to twitter.com or x.com
Find a tweet - Scroll through your feed or go to a specific tweet
Click "AI Reply" - You'll see a blue "AI Reply" button on each tweet
Review & Post - The generated reply appears in the text box. Edit if needed, then post!

Using the Popup

Click the extension icon in your toolbar to access:

Tab	Description
Reply	Configure persona, tone, language, and automation options
Post	Generate project posts, viral content, and hashtags
Schedule	Schedule tweets for future posting
Analytics	View your reply statistics and activity
Target	Set follower ranges, limits, and user lists

Persona Options

Persona	Style
Degen	Crypto degen style, high energy
Analyst	Data-driven, technical analysis, measured
Roast	Witty, sarcastic, playful burns
Maxi	Bitcoin maximalist perspective
Builder	Developer/founder mindset, constructive
Neutral	Balanced, informative, no bias
Custom	Define your own persona

Tone Options

Neutral - Balanced, informative
Bullish - Optimistic, positive outlook
Bearish - Cautious, skeptical perspective
Funny - Humorous, witty responses
Professional - Formal, business-like
Casual - Relaxed, friendly tone

Configuration

Reply Tab Options

Setting	Description
Language	Auto-detect or select specific language for replies
Persona	Choose your AI personality
Custom Persona	Write custom instructions for the AI
Investment Philosophy	Add your beliefs to reflect in responses
Writing Style	Analyze any Twitter user's style to mimic
Auto-Reply	Enable automatic replies to mentions
Tone	Select response tone
Reply Length	Short, Medium, or Long
Auto-Generate	Generate reply automatically
Auto-Comment	Automatically post the reply
Auto-Like	Automatically like the original post
Include @mention	Include author's @username in reply
Action Delay	Delay between automated actions (5-60 seconds)

Targeting Tab Options

Setting	Description
Daily Limit	Maximum replies per day (default: 50)
Min Followers	Only reply to users with at least X followers
Max Followers	Only reply to users with at most X followers
Niche Keywords	Keywords to look for in tweets
Blacklist	Users to never engage with (comma-separated)

Indicators

When browsing Twitter/X, you'll see colored dot indicators next to usernames:

Indicator	Meaning
🟢 Green dot	You replied to this user within the last 24 hours
🔴 Red dot	You haven't replied or reply is older than 24 hours

Project Structure

x-reply/
├── manifest.json          # Extension configuration
├── service_worker.js      # Backend logic & API integration (API_KEY on line 98)
├── content_script.js      # DOM manipulation & UI injection
├── popup.html             # Main popup interface
├── popup.js               # Popup functionality
├── popup.css              # Popup styling
├── notifications.js       # Auto-reply to mentions
├── dashboard.html         # Analytics page
├── dashboard.js           # Analytics logic
├── dashboard.css          # Analytics styling
├── images/                # Extension icons
│   ├── icon-16.png
│   ├── icon-32.png
│   ├── icon-48.png
│   └── icon-128.png
└── _locales/              # Translations
    ├── en/messages.json
    ├── tr/messages.json
    ├── de/messages.json
    ├── fr/messages.json
    └── es/messages.json

Troubleshooting

"API Key not set" Error

Make sure you added your API key to service_worker.js on line 98
Reload the extension after adding the key

AI Reply Button Not Showing

Refresh the Twitter/X page
Make sure the extension is enabled in chrome://extensions/
Try disabling and re-enabling the extension

Replies Not Generating

Check your internet connection
Verify your API key is correct
Check if you've hit the API rate limit

Daily Limit Reached

Enable billing on your Google Cloud account (see Step 2 in API Key Setup)
Without billing, you're limited to 1,500 requests/day

Extension Not Loading

Make sure you selected the correct folder (the one containing manifest.json)
Check for errors in chrome://extensions/

Settings Not Saving

Click "Save Settings" button after making changes
Reload the extension if settings don't persist

API Rate Limits

Without Billing (Free Tier)

15 requests per minute
1,500 requests per day
32,000 tokens per minute

With Billing Enabled

60 requests per minute
Unlimited daily requests
Pay only for what you use (~$0.0001 per request)

Recommendation: Enable billing to avoid hitting daily limits. Set up a budget alert for peace of mind.

Privacy & Security

Your API key is stored locally in the extension files
No data is sent to any server except Google's Gemini API
Reply history is stored locally in Chrome storage
No tracking or analytics are collected by the extension

Disclaimer

This tool is intended for personal use to assist with Twitter/X engagement. Please use responsibly and in accordance with Twitter/X's Terms of Service. Automated engagement should be used thoughtfully to avoid being flagged as spam.

License

ISC License

Contributing

Contributions are welcome! Feel free to:

Report bugs
Suggest new features
Submit pull requests

Support

If you encounter any issues or have questions:

Check the Troubleshooting section
Open an issue on GitHub

Changelog

v1.1.0 (December 2025)

Removed: Bulk auto-comment feature
Updated: DOM selectors for X/Twitter 2025 layout changes
Added: Human-like timing utilities for anti-detection
Added: Turkish language support for DOM selectors
Fixed: Duplicate reply prevention with improved locking mechanism
Added: New DOM helpers (getLikeButton, isLiked, getRepostButton)
Improved: Reply textbox and post button detection for latest X UI

v1.0.0 (November 2025)

Initial release
AI-powered reply generation with Google Gemini
Multiple personas and tone options
Auto-comment, auto-like features
Project post generator and viral hooks
Analytics dashboard
Multi-language support

Made with AI for the Crypto Community

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
_locales		_locales
images		images
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
README.md		README.md
content_script.js		content_script.js
dashboard.css		dashboard.css
dashboard.html		dashboard.html
dashboard.js		dashboard.js
eslint.config.js		eslint.config.js
manifest.json		manifest.json
notifications.js		notifications.js
package-lock.json		package-lock.json
package.json		package.json
popup.css		popup.css
popup.html		popup.html
popup.js		popup.js
service_worker.js		service_worker.js

Bihruze/x-reply

Folders and files

Latest commit

History

Repository files navigation