{"_id":"x-account-cleaner","_rev":"3-ac86194451cd9fcc4737e95094d6a186","name":"x-account-cleaner","dist-tags":{"latest":"2.1.0"},"versions":{"1.0.0":{"name":"x-account-cleaner","version":"1.0.0","keywords":["twitter","x","cleaner","purge","delete-tweets","delete-posts","unfollow","remove-followers","unretweet","vanishx","playwright"],"author":{"url":"https://github.com/Admuad","name":"Admuad"},"license":"MIT","_id":"x-account-cleaner@1.0.0","maintainers":[{"name":"admuad","email":"muhammedadediran6@gmail.com"}],"homepage":"https://github.com/Admuad/x-account-cleaner#readme","bugs":{"url":"https://github.com/Admuad/x-account-cleaner/issues"},"bin":{"vanishx":"dist/index.js","x-cleaner":"dist/index.js","x-account-cleaner":"dist/index.js"},"dist":{"shasum":"17318bdfc77e1beb569aae996f61778ce922f978","tarball":"https://registry.npmjs.org/x-account-cleaner/-/x-account-cleaner-1.0.0.tgz","fileCount":16,"integrity":"sha512-7YWOGsnAi5iaPiv8/VSRFRQDO3W7W7SuHHE1xVCr2E1NilwqM5ZRjBAaBlvehtlk+eOrhuT2umjj4EU6fwYUyQ==","signatures":[{"sig":"MEUCIQDKuva78fo8Zmxr6si8Nw3WfoZjSTge0YE9DVqdb7o7JwIgFjvHGrGFy447HFaI04l/K3fVTa2zlW5xgreskNo6xYM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92217},"main":"dist/index.js","gitHead":"aa02348624a110dc6a86254a48c6506c483cd5fd","scripts":{"ui":"npm --prefix web run dev","test":"ts-node tests/test-archive-whitelist.ts","build":"tsc","clean":"ts-node src/index.ts","start":"ts-node src/index.ts","build:ui":"npm --prefix web run build","start:ui":"npm --prefix web run start","pack:test":"npm pack --dry-run","set-cookies":"ts-node src/set-cookies.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"admuad","email":"muhammedadediran6@gmail.com"},"repository":{"url":"git+https://github.com/Admuad/x-account-cleaner.git","type":"git"},"_npmVersion":"10.9.2","description":"Autonomous browser automation CLI tool to delete X (Twitter) posts, replies, reposts, unfollow accounts, and remove followers safely.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"ora":"^5.4.1","chalk":"^4.1.2","dotenv":"^16.4.5","adm-zip":"^0.5.16","inquirer":"^8.2.6","commander":"^12.1.0","playwright":"^1.49.1"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","@types/ora":"^3.2.0","typescript":"^5.7.2","@types/node":"^20.17.10","@types/chalk":"^2.2.4","@types/adm-zip":"^0.5.7","@types/inquirer":"^8.2.10"},"_npmOperationalInternal":{"tmp":"tmp/x-account-cleaner_1.0.0_1788257604079_0.8765958490622259","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"x-account-cleaner","version":"2.0.0","keywords":["twitter","x","cleaner","purge","delete-tweets","delete-posts","unfollow","remove-followers","unretweet","vanishx","playwright"],"author":{"url":"https://github.com/Admuad","name":"Admuad"},"license":"MIT","_id":"x-account-cleaner@2.0.0","maintainers":[{"name":"admuad","email":"muhammedadediran6@gmail.com"}],"homepage":"https://github.com/Admuad/x-account-cleaner#readme","bugs":{"url":"https://github.com/Admuad/x-account-cleaner/issues"},"bin":{"vanishx":"dist/index.js","x-cleaner":"dist/index.js","x-account-cleaner":"dist/index.js"},"dist":{"shasum":"5855cbed5c488fd0a8db68fe5c78d03c2ce9f111","tarball":"https://registry.npmjs.org/x-account-cleaner/-/x-account-cleaner-2.0.0.tgz","fileCount":16,"integrity":"sha512-RIC8SXAOi/DJ+kgfRJXLYkVJWwPFBqD35OXSfuUyRc2TW79vXgYbMN1JLV1VRLNblqrf6mCRIzkTKGoX99g9CA==","signatures":[{"sig":"MEYCIQCp+RnnWWg31XiuXXPlSoZTuw81roDO+X1Bug9HBbKlDgIhAK18Elx2jtBWjObaFqkS8lIfAepZFoMH7fJyhXyTj7XQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89713},"main":"dist/index.js","gitHead":"40f32acd61bb83d23bd6207b65a351db8072fe88","scripts":{"ui":"npm --prefix web run dev","test":"ts-node tests/test-archive-whitelist.ts","build":"tsc","clean":"ts-node src/index.ts","start":"ts-node src/index.ts","build:ui":"npm --prefix web run build","start:ui":"npm --prefix web run start","pack:test":"npm pack --dry-run","set-cookies":"ts-node src/set-cookies.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"admuad","email":"muhammedadediran6@gmail.com"},"repository":{"url":"git+https://github.com/Admuad/x-account-cleaner.git","type":"git"},"_npmVersion":"10.9.2","description":"Autonomous browser automation CLI tool to delete X (Twitter) posts, replies, reposts, unfollow accounts, and remove followers safely.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"ora":"^5.4.1","chalk":"^4.1.2","dotenv":"^16.4.5","adm-zip":"^0.5.16","inquirer":"^8.2.6","commander":"^12.1.0","playwright":"^1.49.1"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","@types/ora":"^3.2.0","typescript":"^5.7.2","@types/node":"^20.17.10","@types/chalk":"^2.2.4","@types/adm-zip":"^0.5.7","@types/inquirer":"^8.2.10"},"_npmOperationalInternal":{"tmp":"tmp/x-account-cleaner_2.0.0_1788263970852_0.724522174793846","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"x-account-cleaner","version":"2.1.0","description":"Autonomous browser automation CLI tool to delete X (Twitter) posts, replies, reposts, unfollow accounts, and remove followers safely.","main":"dist/index.js","bin":{"x-account-cleaner":"dist/index.js","vanishx":"dist/index.js","x-cleaner":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/Admuad/x-account-cleaner.git"},"bugs":{"url":"https://github.com/Admuad/x-account-cleaner/issues"},"homepage":"https://github.com/Admuad/x-account-cleaner#readme","scripts":{"build":"tsc","prepublishOnly":"npm run build","pack:test":"npm pack --dry-run","start":"ts-node src/index.ts","clean":"ts-node src/index.ts","set-cookies":"ts-node src/set-cookies.ts","test":"ts-node tests/test-archive-whitelist.ts","ui":"npm --prefix web run dev","build:ui":"npm --prefix web run build","start:ui":"npm --prefix web run start"},"keywords":["twitter","x","cleaner","purge","delete-tweets","delete-posts","unfollow","remove-followers","unretweet","vanishx","playwright"],"author":{"name":"Admuad","url":"https://github.com/Admuad"},"license":"MIT","dependencies":{"adm-zip":"^0.5.16","chalk":"^4.1.2","commander":"^12.1.0","dotenv":"^16.4.5","inquirer":"^8.2.6","ora":"^5.4.1","playwright":"^1.49.1"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/chalk":"^2.2.4","@types/inquirer":"^8.2.10","@types/node":"^20.17.10","@types/ora":"^3.2.0","ts-node":"^10.9.2","typescript":"^5.7.2"},"_id":"x-account-cleaner@2.1.0","gitHead":"56c167b21ae10a3c2cb2f04cd5cff7b30611e278","_nodeVersion":"22.17.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-TFttO8QsCxe0I9wlfAVA/eNqHXZGJNNngh/em1POfO+jX+h4Ap0+8/3xsx/WfEcqnLjswTKGp7QHm6XUAEre/g==","shasum":"afc2f3667e7e8cfc74f605cfe24d7917eed4b351","tarball":"https://registry.npmjs.org/x-account-cleaner/-/x-account-cleaner-2.1.0.tgz","fileCount":16,"unpackedSize":93020,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICq2IcRNOlIhB7MqE6CQkMgMFHbzKCuvikEFbGXKzI5iAiBZENAyEiZa8hAOpem32Z7RSng0w+9S5yNq5bPAMuXLng=="}]},"_npmUser":{"name":"admuad","email":"muhammedadediran6@gmail.com"},"directories":{},"maintainers":[{"name":"admuad","email":"muhammedadediran6@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/x-account-cleaner_2.1.0_1788267121438_0.5774354225018132"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-01T10:13:23.822Z","modified":"2026-09-01T12:52:01.708Z","1.0.0":"2026-09-01T10:13:24.194Z","2.0.0":"2026-09-01T11:59:30.998Z","2.1.0":"2026-09-01T12:52:01.564Z"},"bugs":{"url":"https://github.com/Admuad/x-account-cleaner/issues"},"author":{"name":"Admuad","url":"https://github.com/Admuad"},"license":"MIT","homepage":"https://github.com/Admuad/x-account-cleaner#readme","keywords":["twitter","x","cleaner","purge","delete-tweets","delete-posts","unfollow","remove-followers","unretweet","vanishx","playwright"],"repository":{"type":"git","url":"git+https://github.com/Admuad/x-account-cleaner.git"},"description":"Autonomous browser automation CLI tool to delete X (Twitter) posts, replies, reposts, unfollow accounts, and remove followers safely.","maintainers":[{"name":"admuad","email":"muhammedadediran6@gmail.com"}],"readme":"# VanishX — Autonomous X Timeline Purge & Bot Cleanser\n\nA high-performance, client-side cleaning suite for X (Twitter) consisting of a Next.js Web Dashboard, a lightweight Manifest V3 Browser Extension, and a standalone Playwright Automation CLI.\n\nDesigned for surgical timeline purges, date-range filtering, and multi-factor bot detection without requiring expensive Twitter API developer tiers or cloud credential storage.\n\n[![Live Web App](https://img.shields.io/badge/Live%20App-vanishx.vercel.app-FF6044?style=flat&logo=vercel)](https://vanishx.vercel.app)\n[![npm version](https://img.shields.io/npm/v/vanishx.svg?color=cb3837&logo=npm)](https://www.npmjs.com/package/vanishx)\n[![GitHub Repository](https://img.shields.io/badge/GitHub-Admuad%2Fx--account--cleaner-121313?logo=github)](https://github.com/Admuad/x-account-cleaner)\n[![License: MIT](https://img.shields.io/badge/License-MIT-121313.svg)](LICENSE)\n\n---\n\n## 🌐 Live Web Application\n\nAccess the zero-install live web dashboard:\n\n👉 **[https://vanishx.vercel.app](https://vanishx.vercel.app)**\n\n---\n\n## Quick Start\n\n### 1. Terminal CLI (Instant Execution via npx)\n\nRun the autonomous cleaner directly in any terminal with zero clone required:\n\n```bash\nnpx vanishx\n```\n\nOr run headless automated wipes with specific flags:\n\n```bash\n# Delete all historical posts & replies before a date in headless mode\nnpx vanishx --posts --replies --headless\n\n# Mass unfollow non-mutuals with safe pacing\nnpx vanishx --unfollow --min-delay 2000 --max-delay 4000\n```\n\n---\n\n### 2. Companion Browser Extension\n\n1. Download [`vanishx-extension.zip`](https://vanishx.vercel.app/vanishx-extension.zip).\n2. Open `chrome://extensions` in Chrome, Edge, Brave, or Kiwi Browser.\n3. Toggle **Developer mode** ON (top-right).\n4. Drag and drop the extracted `extension/` folder or click **Load unpacked**.\n5. Open [**vanishx.vercel.app/app**](https://vanishx.vercel.app/app) and click **Detect Tab** to start cleaning!\n\n---\n\n### 3. Local Development (Optional)\n\n```bash\n# Clone repository\ngit clone https://github.com/Admuad/x-account-cleaner.git\ncd x-account-cleaner\n\n# Start web dashboard locally\nnpm run ui\n```\n\n---\n\n## CLI Flag Reference\n\n| Flag | Shorthand | Description |\n| :--- | :--- | :--- |\n| `--posts` | `-p` | Delete original authored posts |\n| `--replies` | `-r` | Delete replies and conversation threads |\n| `--reposts` | `-k` | Undo retweets on dedicated `/reposts` tab |\n| `--unfollow` | `-u` | Unfollow non-mutual and flagged bot accounts |\n| `--followers` | `-f` | Remove followers via soft-block method |\n| `--until <YYYY-MM-DD>` | | Filter posts created prior to the specified date |\n| `--turbo` | | High-speed 0.7s execution pacing |\n| `--dry-run` | `-d` | Simulation mode (preview targets without deletion) |\n| `--whitelist <path>` | | Path to custom whitelist configuration |\n| `--headless` | | Execute Playwright in background mode |\n\n---\n\n## Whitelist Configuration (`whitelist.json`)\n\n```json\n{\n  \"usernames\": [\n    \"elonmusk\",\n    \"vitalikbuterin\"\n  ],\n  \"tweetIds\": [\n    \"1759281928391\"\n  ],\n  \"keywordsToKeep\": [\n    \"#keep\",\n    \"#pinned\"\n  ],\n  \"dateCutoff\": \"2026-01-01\"\n}\n```\n\n---\n\n## Security & Privacy Model\n\n1. **Zero External Logging**: No telemetry, tokens, or credentials are transmitted to remote servers.\n2. **Client-Side Session Cache**: Session cookies (`auth_token`, `ct0`) remain stored locally in `.session.json` (git-ignored).\n3. **Adaptive Rate-Limit Protection**: Automatic cooldown triggers with randomized human jitter (400ms–1400ms) to maintain account safety.\n\n---\n\n## License\n\nMIT License. Developed by [Admuad](https://github.com/Admuad).\n","readmeFilename":"README.md"}