Clean up X/Twitter history locally, with a desktop app built for fast, private workflow.
It helps you:
- Delete posts, replies, reposts, media, likes, and highlights in bulk
- Filter cleanup by date, keywords, replies, engagement, and pinned posts
- Unfollow accounts in bulk, with follow-back support
- Keep everything on your machine with no API required
Delete posts, reposts, replies, media, and highlights. Unlike posts in bulk.
Powerful filters:
| Filter | What it does |
|---|---|
| Date range | Only touch posts between two dates |
| Keywords | Only delete posts containing specific words |
| Reply to user | Only delete replies directed at a specific person |
| Reply to post | Only delete replies under one specific tweet |
| Engagement ceiling | Skip posts with too many likes or replies |
| Skip pinned | Preserve your pinned post |
All sign-in prompts appear as floating overlays inside the Chrome window — no switching between apps. The overlay survives page navigations and keeps polling until you're logged in.
GitHub Releases integration. Updates are downloaded in the background and installed on restart.
Get the latest installer from Releases.
| Platform | File |
|---|---|
| Windows | Badger-Setup-x.x.x.exe |
| macOS | Badger-x.x.x.dmg |
| Linux | Badger-x.x.x.AppImage |
- Google Chrome installed (Puppeteer uses your existing Chrome — no separate ChromeDriver)
- Windows 10+, macOS 12+, or recent Ubuntu/Debian
No Node.js required to run the packaged app.
git clone https://github.com/stalane/badger.git
cd badger
npm install
npm run dev # hot-reload dev mode
npm run dist:win # build Windows installer
npm run dist:mac # build macOS DMG
npm run dist:linux # build Linux AppImageBefore running dist, the app icons are already in build/:
build/icon.ico— Windowsbuild/icon.icns— macOSbuild/icon.png— Linux + taskbar (512×512)
If you want to regenerate them from logo.png (512×512 source), replace the files in build/ with your exported app icons.
For AppX/MSIX or Microsoft Store packaging, use the tile assets in build/appx/:
build/appx/StoreLogo.pngbuild/appx/Square150x150Logo.pngbuild/appx/Square44x44Logo.pngbuild/appx/Wide310x150Logo.png
Releases: This project publishes releases via GitHub Actions. The CI workflow is in .github/workflows/main.yml. It runs on every push to main and creates a draft release with the new version number from package.json. You can then edit the release notes and publish it manually.
Electron main process
├── scraper/x-cleaner.ts Puppeteer: deletes posts/replies/media/likes, unfollows
├── scraper/github-star.ts Puppeteer: stars this repo on GitHub
├── scraper/browser-ui.ts Injects floating overlay into Chrome pages
├── scraper/updater.ts electron-updater GitHub Releases
└── index.ts IPC handlers, window, default paths
Preload (contextBridge)
└── index.ts Exposes window.api to renderer
Renderer (React + TypeScript + Tailwind v4)
└── App.tsx Full UI — tabs, filters, log, summary modal
Badger opens Chrome with a persistent overlay. On X:
- If not logged in → overlay shows "You're not logged in"
- You sign in normally in Chrome (URL changes are fine)
- Overlay checks every 30s automatically
- Or click I'm logged in ✓ once your feed is visible
- Username is auto-detected via 5 different strategies
All logs are JSON, saved to the folder you choose (default: Documents/badger-output).
| File | Contents |
|---|---|
deleted-posts.json |
Deleted posts |
deleted-reposts.json |
Undone reposts |
deleted-replies.json |
Deleted replies |
unliked-posts.json |
Unliked posts |
deleted-media.json |
Posts deleted via the media tab |
deleted-highlights.json |
Deleted highlights |
Everything runs on your machine. Nothing is sent to any server. Your credentials live only in the Chrome profile stored in your app data folder.
PRs welcome. Open an issue first for significant changes.
src/main/scraper/ Add new automations here
src/renderer/src/ React UI
MIT © 2026 stalane
