What the GitHub repo actually is:
This is the For You feed stack, split into 4 big parts:
โ home-mixer = It pulls everything together and decides what shows up on for you
โ thunder = This handles posts from people you already follow. Familiar, low-risk content.
โ phoenix = This finds posts from people you donโt follow and figures out which ones youโre most likely to care about using Grok.
โ candidate-pipeline = This is the assembly line. It:
grabs possible posts
compares it to your preferences
filters out junk
picks the winners
sends them to your feed
The README just walks through that entire process step by step from opening the app to the posts you actually see.

Quick Detour for my sponsors today: DEEL
Check out what they are offering for my readers:
AI in HR? Itโs happening now.
Deel's free 2026 trends report cuts through all the hype and lays out what HR teams can really expect in 2026. Youโll learn about the shifts happening now, the skill gaps you can't ignore, and resilience strategies that aren't just buzzwords. Plus youโll get a practical toolkit that helps you implement it all without another costly and time-consuming transformation project.
๐จ OKAY BACK TO TOPIC ๐จ
THE EVALUATION YOU GO THRU
When someone opens the For You, this is how the algo evaluates available posts:
1) Query hydration
They fetch your:
โ recent engagement history
โ following list + preferences
2) Candidate sourcing (get posts to consider)
Two streams:
โ Thunder (in-network)
Posts from accounts you follow, served fast from an in-memory store.
โ Phoenix Retrieval (out-of-network)
It does two things at the same time:
One side builds a profile of you based on what youโve been interacting with lately
The other side builds a profile of every post being created
Then it compares the two and asks:
โWhich posts look the most like things this person usually engages with?โ
The closer the match, the higher those posts get pushed into your feed.
3) Hydration (enrich candidates)
Adds metadata:
โ text/media
โ author info
โ video duration
โ subscription eligibility
4) Pre-scoring filters (remove junk before spending ML)
Filters include:
โ duplicates
โ too old
โ your own posts
โ blocked/muted authors
โ muted keywords
โ previously seen / previously served
โ subscription ineligible content
โผ๏ธ 5) Scoring (the โranking brainโ)
This is the part that actually decides what gets shown and what disappears.
Grok looks at a post and asks:
โWhat are the chances someone will actually do something with this?โ
Not just "likes", it predicts:
โ will they stop and read
โ will they reply
โ will they share it
โ will they click the profile
โ or will they mute, block, or hit โnot interestedโ
Every possible reaction gets weighed. Posts that are likely to get good reactions move up. Posts that are likely to get bad reactions get pushed down or removed.
So your reach isnโt random.
itโs the system constantly guessing how people will react to you before your post even finishes circulating.
And then they layer on:
โ Author Diversity Scorer (suppresses repeated authors on feed)
โ OON Scorer (adjusts out-of-network content)
6) Select top K + post-selection filters
Final cleanup includes:
โ visibility / safety filtering
โ conversation deduping (donโt show 7 branches of the same argument)
The README shows predicted actions like:
Positive
โ favorite/like, reply, repost, quote
โ click, profile_click
โ video_view, photo_expand
โ share, dwell
โ follow_author
Negative
โ not_interested, block_author, mute_author, report
So yes: the system is literally designed to reward what people are likely to enjoy and bury what theyโre likely to reject. (are we surprised?)
What this means for creators (the โhow to winโ)
If you want your posts to show up on for you, optimize for:
1) Dwell + completion
โ first 2 lines must create a pause
โ scannable formatting keeps them reading
โ video needs retention, not just a view
2) High-intent actions
Likes are cool. But these are the real engagement signals you should optimize your content for:
โ replies that arenโt one-word junk
โ profile clicks
โ follows
โ shares / DMs
3) Avoid negative reactions
If your content causes โnot interestedโ, mutes, blocks you'll receive "negative scoring".
4) Stop spamming your own reach
The repo explicitly includes an Author Diversity Scorer. Translation: you showing up repeatedly (posting toooo much) gets devalued. Nobody needs to post more than 8-10 times a day IMO.
2nd sponsor of the day: Check out what ATTIO is offering for you guys:
AI-native CRM
โWhen I first opened Attio, I instantly got the feeling this was the next generation of CRM.โ
โ Margaret Shen, Head of GTM at Modal
Attio is the AI-native CRM for modern teams. With automatic enrichment, call intelligence, AI agents, flexible workflows and more, Attio works for any business and only takes minutes to set up.
Join industry leaders like Granola, Taskrabbit, Flatfile and more.
3rd sponsor of the day: Check out what HUBSPOT is offering for you guys:
Turn AI into Your Income Engine
Ready to transform artificial intelligence from a buzzword into your personal revenue generator?
HubSpotโs groundbreaking guide "200+ AI-Powered Income Ideas" is your gateway to financial innovation in the digital age.
Inside you'll discover:
A curated collection of 200+ profitable opportunities spanning content creation, e-commerce, gaming, and emerging digital marketsโeach vetted for real-world potential
Step-by-step implementation guides designed for beginners, making AI accessible regardless of your technical background
Cutting-edge strategies aligned with current market trends, ensuring your ventures stay ahead of the curve
Download your guide today and unlock a future where artificial intelligence powers your success. Your next income stream is waiting.
BTWโฆ Grab my guide on how I organically went from 0 to 20k+ followers in a short amount of time:

0 to 20k Followers in 0 to 60 Seconds
Hereโs whatโs actually worked for me (and might work for you too if you apply them)
QUESTIONS?
Reply and ask!
I fed the entire X algo code to my AI and I can ask it anything you need.
๐ BTW for more breakdowns like this, make sure youโre following me on ๐: @aunysillyme
You can also hop on a call with me if you need help with your content strategy, monetization or anything related to social media and X in general:

1 Hour Content and Branding Advising Call
Hop on a 1-on-1 call with me where Iโll go over your profile and answer questions
SEE YOU ON THE NEXT ONE
- AUNY ๐งก




