TwitterClean

A local Chrome extension that deletes tweets from your open Twitter/X page by reusing your current browser session. It does not use the public Twitter/X API or ask for API keys.

Load The Extension

1. Download this repo, for example downloading the packaged zip archive, and extract it.
2. Open Chrome and go to chrome://extensions.
3. Enable Developer mode.
4. Choose Load unpacked.
5. Select the folder that contains the repo.

Use On Twitter/X

1. Open your profile replies page on https://x.com/YOUR_HANDLE/with_replies.
2. Click the TwitterClean extension icon.
3. Keep Dry run on for the first pass and press Start.
4. Watch the popup count. When you are comfortable, turn dry run off and start again.

Safety Model

• The extension only runs after you press Start in the popup.
• Dry run is enabled by default. In dry run mode it finds tweet IDs, but it does not send delete requests. Disable the dry-run mode to delete the tweets in addition to IDs retrieval.
• While deleting, the popup estimates remaining duration and finish time from the current queue and delay. Rate-limit cooldowns update the estimate live too.
• The selected delay is applied between timeline retrieval and delete requests, rate limit errors are detected and temporarily pause the process to allow quota reset.

Development

Install dependencies if needed:

npm install

Run the mock test:

npm test

The test loads the extension in Chromium, opens a mock Twitter-like page, starts deletion from the popup, and asserts that mock tweets are removed through a GraphQL-shaped POST endpoint.