lifofifoX/replyguy

★ 0Forks 0JavaScriptGitHub ↗Compare

README

ReplyGuy

A dashboard for finding high-opportunity tweets and drafting engaging AI-powered replies.

Features

  • Background Curation - Browses your For You feed, clicks interesting tweets to train X's algorithm
  • Smart Reply Generation - Different styles for tech vs culture tweets
  • Proxy Support - Route through residential proxies to avoid rate limits
  • One-Click Reply - Copy or open directly in X with pre-filled text

Setup

1. Clone and Install

git clone <repo>
cd replyguy
npm install

2. Configure Environment

cp .env.example .env

Add your Anthropic API key:

ANTHROPIC_API_KEY=sk-ant-...

Get one at console.anthropic.com

3. Export Your X Cookies

The app uses your X session to browse tweets:

  1. Install Cookie-Editor (Chrome) or Cookie-Editor (Firefox)

  2. Go to x.com and make sure you're logged in

  3. Click the extension → Export → Export as JSON

  4. Save as src/data/x-cookies.json

4. Set Up Voice Profile (Optional)

The voice profile helps generate replies that match your writing style:

cp src/data/voice-profile.example.json src/data/voice-profile.json

Edit voice-profile.json to reflect your style preferences, or leave the defaults.

5. Set Up Proxy (Recommended)

X rate-limits aggressively. A residential proxy helps avoid blocks:

PROXY_URL=http://user:[email protected]:8080

Providers: IPRoyal, Smartproxy, Oxylabs

6. Start

npm start

Open http://localhost:3000

Usage

Dashboard

  1. Background curation runs automatically - Browses For You every 3-6 minutes
  2. Click a tweet card - Opens modal with AI-generated reply options
  3. Pick or edit a reply - Click to select, modify if needed
  4. Reply on X - Opens tweet with your reply pre-filled
  5. Refresh for variations - Click ↻ for new options

Compose Page

Go to /compose.html to:

  • Paste any tweet URL
  • Add custom context/direction
  • Generate replies with all 4 styles

Reply Styles

Style Description
🎯 witty Clever wordplay, puns
🔥 savage Brutal, no mercy
🤪 chaotic Unhinged, absurdist
😐 deadpan Dry, understated

Auto-detects tweet type:

  • Tech/AI tweets → Insightful, value-adding
  • Culture tweets → Short, snarky one-liners

Configuration

Variable Required Description
ANTHROPIC_API_KEY Yes Claude API key
PROXY_URL No Residential proxy URL
PORT No Server port (default: 3000)

Data Files

File Description
src/data/x-cookies.json Your X session cookies
src/data/voice-profile.json Writing style preferences

Troubleshooting

"Not logged in" errors - Re-export your X cookies

Timeouts / empty results - Add a proxy, X rate-limited your IP

No tweets showing - Wait for a curate cycle (3-6 min), check console

License

MIT

Contributors

lifofifoX

Issues