Note: Results show your current connections. GitHub's public API has no unfollow history, so this tool shows who doesn't follow back right now — not who unfollowed you and when.

Requirements: Node.js 20+ or Bun

git clone https://github.com/lewiii254/github-unfollower-finder.git
cd github-unfollower-finder
bun install        # or: npm install
bun run dev        # or: npm run dev

Open the local URL shown in your terminal and enter a GitHub username.

The checker itself needs no configuration. The optional AI insights feature runs on the server and needs:

 username ──► GitHub public API (from your browser)
                 │
                 ├─ /users/:name            profile + counts
                 ├─ /users/:name/followers  paginated, fetched in parallel
                 └─ /users/:name/following  paginated, fetched in parallel
                 │
                 ▼
        compare sets in the browser
                 │
   ┌─────────────┼──────────────┬─────────────┐
   ▼             ▼              ▼             ▼
Not following  Not mutuals    Mutuals     Followers / Following
   back      (minus protected accounts from localStorage)
                 │
                 ▼ (optional, only accounts you tick)
        server function ──► AI Gateway ──► summary + review list

Rate limits: unauthenticated GitHub requests are limited to about 60 per hour per IP, and each page holds 100 accounts. Very large accounts (~20,000+ combined connections) may not be checkable in one go.

• Nothing to sign into — the app never asks for GitHub access.
• Data stays in your browser — follower lists are fetched and compared on your device.
• Protected list is local — stored in localStorage under unfollow:whitelist.
• AI is opt-in — only the usernames you tick, plus your counts, are sent when you press Summarize.
• No changes to your account — unfollowing only ever happens on GitHub, by you.

• TanStack Start — full-stack React 19 with server functions
• TanStack Router & Query
• Tailwind CSS v4 + shadcn/ui
• Lucide icons · Vite · Vitest

src/
├─ routes/index.tsx           # The checker page and dashboard
├─ lib/insights.functions.ts  # AI summary server function
├─ components/ui/             # shadcn/ui components
└─ styles.css                 # Design tokens and theme

• Optional personal token (kept in the browser) for higher rate limits
• Snapshot history to show real "unfollowed you since…" changes
• Export results as CSV / JSON
• Copy gh CLI commands to bulk-unfollow from your terminal
• Flag inactive accounts
• Sort by followers, join date and more

Have an idea? Open an issue.

Contributions of all sizes are welcome!

1. Fork the repo
2. Create a branch: git checkout -b feature/my-idea
3. Commit: git commit -m "Add my idea"
4. Push: git push origin feature/my-idea
5. Open a pull request

Please run bun run lint and bun run test before submitting.

Released under the MIT License.