We’ve all been there. You look at your X (formerly Twitter) profile and realize you have thousands of old tweets, cringy replies, and outdated retweets from a decade ago. It’s time for a clean slate.
In the past, you could just plug your account into a free third-party app and wipe your history in minutes. But ever since X changed its API pricing, almost all of those free tools have either shut down or started charging hefty subscription fees.
So, how do you clean up your digital footprint without opening your wallet?
Enter twitter-x-cleaner-automation: a completely free, open-source tool that runs directly on your computer to bulk delete your X history.
In this article, I’ll explain how this tool works, why it’s safe to use, and how absolutely anyone—even non-developers—can set it up in minutes.
🚀 What is this tool?
This tool is a lightweight script that automates the tedious process of deleting your X content. Instead of using expensive API keys to talk to X's servers behind the scenes, this tool uses Browser Automation.
Imagine hiring a tireless digital assistant who sits at your computer, opens Google Chrome, scrolls through your profile, clicks the three-dot menu on every single post, and hits "Delete." That is exactly what this script does, just much faster.
What can it clean up?
- Posts: Deletes your original tweets.
- Replies: Removes all the replies you’ve left on other people's posts.
- Retweets (Reposts): Undoes retweets on your timeline.
- Likes: Un-hearts posts you’ve previously liked.
🧠 How it Works (No Coding Degree Required)
You don't need to be a programmer to use this, but understanding how it works will give you peace of mind.
The script uses a technology called Puppeteer. Puppeteer is an invisible "puppeteer" for your web browser. When you run the tool, it does the following:
- Opens Chrome: It launches a local version of Google Chrome right on your screen.
- Logs You In: It uses a secure, local profile. The first time you run it, you'll log in just like you normally do. After that, it remembers you.
- Scans and Clicks: It automatically navigates to your profile, uses visual cues to find posts that belong to you, clicks the specific "Delete" or "Unlike" buttons, and confirms the prompt.
- Keeps Receipts: As it works, it saves a neat little log file (like a digital receipt) on your computer, so you always know exactly what text was deleted and when.
Because it mimics human behavior—actually clicking buttons on the website—it completely bypasses the need for API keys. Furthermore, it has built-in smarts. If X notices you are deleting things too fast and tries to pause you (a "rate limit"), the script will automatically wait for 60 seconds and resume.
🔒 Why This is the Safest Way to Clean Your Account
When you use sketchy third-party web apps, you are often asked to authorize their app to access your account. This means giving a stranger's server permission to post, delete, or read your messages.
This tool is entirely different:
- 100% Private: It runs only on your computer. Your passwords and data are never sent to any cloud server.
- Transparent: It’s open-source. Anyone can look at the code to verify it does exactly what it says and nothing else.
- No Account Bans: By mimicking normal browser clicks and respecting X's rate limits, it avoids triggering bot-detection alarms.
🛠️ Step-by-Step Guide: How to Use It
Ready to nuke your timeline? Here is how to get started.
Prerequisites
Before you begin, ensure you have the following installed on your Windows PC:
- Google Chrome (Your everyday browser).
- Node.js (Version 18 or newer). Just download the Windows installer and click "Next" until it's finished.
Step 1: Download the Tool
Go to the GitHub Repository. Click the green <> Code button and select Download ZIP. Extract the folder anywhere on your computer (like your Desktop).
Step 2: Open your Terminal
Open your computer's Command Prompt (or Terminal) and navigate to the folder you just extracted.
(Tip: You can open the extracted folder, click the address bar at the top of the window, type cmd, and press Enter. This opens a terminal right in that folder!)
Step 3: Install the Magic
In the terminal window, type the following command and press Enter:
npm install
This downloads the small set of instructions the script needs to run.
Step 4: Run the Cleaner
Now, start the tool by typing:
node script.js
Step 5: Choose Your Adventure
The tool will greet you with a friendly menu:
What would you like to do? (enter numbers separated by commas)
1) Delete posts
2) Delete replies
3) Undo retweets
4) Unlike posts
5) All of the above
Your choice (e.g. 1,3,4):
Just type the numbers for what you want to do and press Enter.
A Chrome window will pop up. If it's your first time, the terminal will ask you to sign into X. Just log in manually in that Chrome window, switch back to your terminal, and press Enter
Sit back and watch. The tool will auto-detect your username and start scrubbing your profile. You can literally watch the posts disappear one by one!
📂 Advanced Options
If you want to be more specific, you can give the tool extra commands right from the start.
Want to delete exactly 100 posts?
node script.js @yourhandle 100
Want to start a completely fresh log file instead of keeping a running list?
node script.js @yourhandle 100 overwrite
All of your deleted history will be saved neatly inside the output/ folder in the tool's directory, categorized by actions (e.g., deleted-posts.json).
🏁 Final Thoughts
Taking control of your digital footprint shouldn't cost you a monthly subscription. Thanks to browser automation, we can take back control of our data for free, securely, and privately.
If this tool helped you clean up your timeline, be sure to head over to the twitter-x-cleaner-automation GitHub repo and give it a ⭐ Star to support the project!
Happy cleaning! 🧹✨