@Sudhirkrs17 growth engine
A self-running system to grow @Sudhirkrs17 to 10,000+ followers, built on GitHub and Vercel only. No paid X API is needed: you post with one tap, and everything else is prepared, drafted and measured for you.
How it works
| Piece | Where | What it does |
|---|
| Daily brief | GitHub Issues (daily-brief.yml) | Every evening, opens an issue with the next day's posts and an ➜ Open in X link under each one |
| Posting Desk | GitHub Pages: https://sudhirkrs.github.io/twitter/ | Phone page for any day: Open in X, Open X app, Copy for thread parts |
| News tweets | GitHub Actions (news-tweets.yml), run on demand | Reads the latest Indian news on personal finance, stocks, payments or AI and turns each story into a ready-to-post tweet ending with the article link, so readers can see the source (AI-written with an AI key, template-based without). The issue has just the tweets, each with an Open in X link. |
| Control Panel | Vercel (dashboard/) | Edit, approve, add and delete posts; log your numbers; see Insights; start any job, including News tweets |
| X numbers bookmark | Your own browser (dashboard/x-reader.js) | On your X profile, signed in, it reads the views, likes, replies, reposts and bookmarks under your posts plus your follower count, and sends them to the Control Panel to review and save. It only reads the screen; no password leaves your browser. |
| Weekly AI drafts | GitHub Actions (draft-week.yml) | Every Sunday, drafts the next 7 days with an AI model you choose, when fewer than 14 days are queued. Drafts wait for your approval. |
| Weekly report | GitHub Issues (weekly-report.yml) | Every Sunday evening: follower trend, best posts, best topics and formats, content runway |
| Content | content/queue.json | All posts. "status": "draft" posts get no Open in X link until approved. |
| Numbers | tracking/ | growth-log.csv (weekly account numbers) and post-metrics.csv (per post), written by the Control Panel |
| Strategy | STRATEGY.md | Positioning, profile, content pillars, the daily reply routine, milestones |
Your routine
Daily (about 5 minutes of posting, plus replies)
- Evening before: a GitHub notification arrives, e.g. "Posts for Fri 09 Oct 2026". (It's prepared a day ahead because GitHub often starts scheduled jobs hours late.)
- 08:30: in the issue, tap ➜ Open in X under the morning post → Post. For threads, post part 1, then reply with each next part, long-pressing a box to copy it.
- 19:30: same for the evening post. Polls: create them in the X app with the options shown.
- Spend 45 minutes replying to bigger accounts (
STRATEGY.md §3). That's where the growth comes from.
Whenever there's news worth covering
- GitHub → Actions → News tweets → Run workflow (or Control Panel → Automation → Get news tweets). Pick a topic and how many.
- A "News tweets" issue appears in about a minute with ready tweets. Read each one, tap ➜ Open in X, then Post. The Open in X links work about 2 minutes after the issue appears.
Sunday (about 20 minutes)
- On x.com, signed in, open your profile and tap the X numbers bookmark → Review and save in Control Panel → Save. (Or type the numbers in under Log numbers.)
- Read the Weekly report issue, or the Control Panel's Insights tab.
- Control Panel → Posts: edit the new AI drafts, then tap Approve this day. Check every number and claim; the AI can be wrong.
One-time setup
GitHub Pages and the daily brief are already running. Two things remain.
1. Control Panel on Vercel (about 10 minutes)
- Create a GitHub token the panel will use to save changes: github.com → Settings → Developer settings → Fine-grained tokens → Generate new token.
- Repository access: Only select repositories →
sudhirkrs/twitter
- Permissions: Contents: Read and write, Actions: Read and write (Metadata: Read is added automatically)
- Set an expiry you're comfortable with, and put a reminder in your calendar to renew it.
- Import the repo on Vercel: vercel.com → Add New… → Project → import
sudhirkrs/twitter.
- Root Directory:
dashboard
- Framework Preset: Other (no build command needed)
- Environment Variables:
ADMIN_PASSWORD: a long password only you know. It's the panel's login.GITHUB_TOKEN: the token from step 1
- Click Deploy. Vercel gives you an address like
https://twitter-xxxx.vercel.app.
- Tell GitHub where the panel is: repo Settings → Secrets and variables → Actions → Variables → add
CONTROL_PANEL_URL = your Vercel address. The "drafts ready" notification links to it.
After changing a Vercel environment variable, use Deployments → ⋯ → Redeploy so the panel picks it up.
2. AI key: Google Gemini, free tier (about 5 minutes)
The same key writes the News tweets and the weekly drafts. Any OpenAI-compatible provider works; these steps use Google Gemini's free tier. Free tiers have daily limits, which are plenty for a few runs a day. Google may use free-tier prompts to improve its products, but your prompts are only public news and your own tweets.
- Get the key: open aistudio.google.com in a browser, sign in with your Google account, tap Get API key → Create API key, and copy it. Treat it like a password.
- Add three secrets on GitHub in a browser (the GitHub app can't do this): github.com/sudhirkrs/twitter → Settings → Secrets and variables → Actions → New repository secret:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
