Score your tweets before posting based on X's actual recommendation algorithm. Get real-time feedback to maximize your reach.

A Chrome extension that analyzes your draft tweets against X's (Twitter's) open-sourced algorithm, providing instant scoring, actionable suggestions, and predicted reach estimates.

• Features
• Screenshots
• Installation
• Usage
• Algorithm Insights
• AI-Powered Analysis
• Score Breakdown
• Privacy
• Development
• Roadmap
• Contributing
• License

• Real-time Scoring — See your tweet's algorithm score (0-100) as you type
• Letter Grades — S/A/B/C/D/F grading system for quick assessment
• Score Breakdown — Understand how content, media, timing, engagement, and risk factors affect your reach
• Actionable Suggestions — Get specific tips based on algorithm research
• Predicted Reach — Estimate impressions based on your score

• AI Analysis — Deep analysis with Claude API for originality, audience fit, and rewrite suggestions
• Algorithm Factors — See exactly which signals are optimal, suboptimal, or harmful
• Media Detection — Automatically detects images, videos, GIFs, and polls
• Link Warnings — Critical alerts for external links (especially for non-Premium accounts)
• Template Detection — Identifies overused formats that get penalized

Screenshots are coming soon. (The repo currently ships icons in assets/, but not marketing screenshots yet.)

1. Download the latest release from the GitHub Releases page for this repository
2. Unzip the downloaded file
3. Open Chrome and navigate to chrome://extensions/
4. Enable Developer mode (toggle in top-right corner)
5. Click Load unpacked
6. Select the unzipped dist folder
7. Navigate to x.com and start composing!

1. Pin the extension (puzzle icon → pin “X Algorithm Score”)
2. Go to x.com → click compose
3. If the overlay doesn’t show, open the popup → Settings:
   • Enable extension
   • Show score while composing

# Clone the repository
git clone https://github.com/affaan-m/x-algorithm-score.git
cd x-algorithm-score

# Install dependencies
npm install

# Build the extension
npm run build

# Load the dist/ folder in Chrome (see Option 1, step 3-7)

Coming soon!

1. Navigate to x.com or twitter.com
2. Click to compose a new tweet
3. The score badge appears in the bottom-right corner
4. Type your tweet and watch the score update in real-time
5. Click the badge to expand and see detailed analysis
6. Follow suggestions to improve your score before posting

Click the extension icon (XS) to open the popup:

• Enable extension: Master on/off
• Show score while composing: Controls the overlay on x.com
• Show suggestions: Toggle suggestions UI in the overlay
• Minimum score alert: Shows a warning when score is below your target
• Score history (optional): If enabled, saves a local entry when you post
• Claude API key (optional): Enables AI analysis (sends draft text to Anthropic when triggered)

This extension provides draft tweet scoring based on analysis of:

• xai-org/x-algorithm — X's open-source feed ranking pipeline (2025-2026)
• twitter/the-algorithm — Initial open-source release (2023)
• Community research — Creator best practices and observed patterns

These insights are directly traceable to xai-org/x-algorithm:

Important: Actual weight values (e.g., FAVORITE_WEIGHT, REPLY_WEIGHT) are configured in params and not published in the open-source code.

These insights are based on community research and observed patterns, not directly verifiable from open-source code:

See INSIGHTS_AUDIT.md for full source attribution and methodology.

Enable deep analysis with Claude AI for enhanced feedback:

1. Get an API key from console.anthropic.com
2. Open the extension popup
3. Go to Settings tab
4. Enter your API key and save

• Originality Assessment — Detects template/generic content
• Engagement Prediction — Reply likelihood and viral potential
• Rewrite Suggestions — AI-generated improvements
• Audience Analysis — Who your tweet appeals to

Note: When you click the AI analysis button, your draft tweet text is sent to the Anthropic API using your locally-stored API key. The base score and suggestions are computed locally. See PRIVACY_POLICY.md.

• Media attached: +12-20 points (video highest)
• Question included: +8 points (drives replies)
• Optimal length (120-240 chars): +8 points
• Thread format: +3-5 points
• Call-to-action: +4 points

• External links: -15 (Premium) / -20 (non-Premium)
• Excessive hashtags (>2): -3 per extra
• Excessive mentions (>3): -2 per extra
• Template content: -5 points
• Negative sentiment: -3 points

• 100% Local Processing — All scoring happens in your browser
• No Data Collection — Tweet content never leaves your device
• No External Servers — No backend, no tracking, no analytics
• No X API Access — Works without authentication
• Open Source — Audit the code yourself

The only external call is optional AI analysis (using your own API key).

• TypeScript — Type-safe development
• React 18 — UI components
• Vite + CRXJS — Fast builds with HMR
• Tailwind CSS — Styling
• Manifest V3 — Modern Chrome extension API

# Install dependencies
npm install

# Development mode (hot reload)
npm run dev

# Production build
npm run build

# Run tests
npm run test

# Type checking
npm run type-check

# Linting
npm run lint

# Full quality gate (typecheck + lint + test + build)
npm run check

src/
├── background/       # Service worker
├── content/          # Content script + overlay
│   ├── components/   # React components
│   └── index.tsx     # Entry point
├── lib/              # Core logic
│   ├── scoring-engine.ts   # Algorithm scoring
│   └── ai-analysis.ts      # Claude API integration
├── popup/            # Extension popup
└── types/            # TypeScript definitions

• Timeline tweet scoring (show scores on existing tweets)
• Score history tracking with export to CSV
• User context integration (follower count, engagement rate)

• Thread composer with per-tweet scoring
• Optimal posting time suggestions
• Analytics dashboard with trends and insights
• A/B testing variant generator

• Chrome Web Store release
• Enhanced timeline scoring with filters
• Historical performance tracking

• Firefox support
• Safari support
• Advanced analytics with A/B test results
• Automated best time scheduler

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See CONTRIBUTING.md for local dev setup and guidelines.

Read the detailed comments in src/lib/scoring-engine.ts to understand the algorithm analysis and scoring logic.

This extension is based on publicly available information from Twitter's open-source algorithm release and community research. Scoring predictions are estimates. Actual tweet performance depends on many factors including:

• Your audience size and engagement
• Posting timing
• Content quality and relevance
• Current events and trends
• X's constantly evolving algorithm

MIT License - see LICENSE for details.

• twitter/the-algorithm — Open-source algorithm release
• Community researchers and creators who shared their findings
• Anthropic Claude — AI analysis capabilities

Built to help creators maximize their reach on X
Report Bug · Request Feature