Skip to content

ChrisRomp/bsky-cleaner

Repository files navigation

Bluesky Cleaner

Bluesky Cleaner logo

A web-based tool to help you clean up your old Bluesky posts, likes, reposts, and follows.

👉 Use it now

Features

  • 100% Client-Side - Your credentials never leave your browser
  • Browse Content - View your posts, likes, reposts, and follows with pagination
  • Smart Filtering - Filter by date range and keyword search
  • Bulk Selection - Select individual items or all filtered results
  • Dry Run Preview - See a summary before deleting (counts, date range, detected topics)
  • Safe Deletion - Confirmation dialogs and progress indicators
  • Dark Mode - Automatic dark mode support based on system preferences

Privacy & Security

  • Uses Bluesky App Passwords for authentication
  • Credentials are stored only in memory during your session
  • No data is sent to any third-party servers
  • All API calls go directly from your browser to Bluesky

Getting Started

Local Development

# Clone the repository
git clone https://github.com/ChrisRomp/bsky-cleaner.git
cd bsky-cleaner

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Usage

  1. Create an App Password in your Bluesky settings
  2. Enter your handle (e.g., username.bsky.social) and app password
  3. Browse your content using the tabs (Posts, Likes, Reposts, Follows)
  4. Use filters to narrow down what you want to delete
  5. Select items by clicking on them or use "Select All"
  6. Click "Delete selected" to see a preview summary
  7. Confirm to delete the selected items

Tech Stack

Contributing

Found a bug or have a feature request? Please open an issue.

Credits

Built with GitHub Copilot CLI and GitHub Copilot Coding Agent.

License

AGPL-3.0 - This software is free to use and modify, but any modifications must be shared under the same license. If you run a modified version as a network service, you must make the source code available to users.

About

A secure web utility for cleaning up your Bluesky feed.

Resources

License

Stars

Watchers

Forks

Contributors

Languages