whatisgithub

What is x-algorithm-score?

affaan-m/x-algorithm-score — explained in plain English

Analysis updated 2026-05-18

23TypeScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

X Algorithm Score is a Chrome extension that scores your draft tweet against X's known ranking algorithm before you post it, all processed locally.

Mindmap

mindmap
  root((X Algorithm Score))
    What it does
      Live tweet scoring
      Letter grade badge
      Improvement suggestions
      Local-only processing
    Tech stack
      TypeScript
      React
      Vite
    Use cases
      Score draft tweets live
      Get engagement tips
      Optional Claude deep analysis
    Scoring factors
      Tweet content
      Media attached
      Post timing
      Risk penalties

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See a live letter grade and score for your tweet as you type it, based on X's public ranking algorithm.

USE CASE 2

Get specific suggestions for improving engagement, like adding media or avoiding risky posting patterns.

USE CASE 3

Use the optional Claude-powered deep analysis for detailed rewrite suggestions with your own API key.

What is it built with?

TypeScriptReactVite

How does it compare?

affaan-m/x-algorithm-scoread3lre/echoav/skilled
Stars232323
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity2/54/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Not published to the Chrome Web Store yet, so you must build it and load it manually as an unpacked extension, the optional deep-analysis feature needs your own Anthropic API key.

MIT license, free to use, modify, and distribute, including for commercial purposes.

So what is it?

X Algorithm Score is a Chrome extension that gives you a score for a tweet before you post it, based on what is publicly known about how X's recommendation algorithm ranks content. As you type in the tweet composer on x.com, a floating badge appears showing a letter grade from S down to F and a numeric score from 0 to 100. Clicking the badge expands a panel with specific suggestions for improvement, a breakdown of how the score was calculated, and an explanation of the algorithm signals involved. The scoring breaks down into five parts: the content of the tweet itself, whether media like video or images is attached, the time of day you are posting, signals that drive engagement like questions or calls to action, and a risk penalty for things the algorithm tends to punish such as external links, too many hashtags, or overused posting templates. These weights are based on the algorithm code that Twitter made public in 2023 as well as community research into how the ranking actually behaves in practice. For example, the algorithm gives a 75x multiplier to replies you write back to people who comment on your post, and a large negative multiplier to posts that get reported or blocked. All of the scoring runs locally inside your browser. Your tweet text is never sent anywhere. There is an optional deep-analysis feature powered by Claude that gives more detailed feedback including rewrite suggestions, but that requires you to supply your own Anthropic API key, which is stored only in your browser and sent only to Anthropic. The extension is built with TypeScript, React, and Vite. It has not yet been published to the Chrome Web Store, so you install it manually by building the project and loading the output folder as an unpacked extension. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how X Algorithm Score calculates its five scoring factors and why replies get a 75x multiplier.
Prompt 2
Walk me through building this extension and loading it as an unpacked extension in Chrome.
Prompt 3
How do I set up the optional Claude deep-analysis feature and where is my Anthropic API key stored?
Prompt 4
What kinds of tweets does this extension flag as risky, and why does the algorithm penalize them?

Frequently asked questions

What is x-algorithm-score?

X Algorithm Score is a Chrome extension that scores your draft tweet against X's known ranking algorithm before you post it, all processed locally.

What language is x-algorithm-score written in?

Mainly TypeScript. The stack also includes TypeScript, React, Vite.

What license does x-algorithm-score use?

MIT license, free to use, modify, and distribute, including for commercial purposes.

How hard is x-algorithm-score to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is x-algorithm-score for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.