2025-12-11 11:01:57 +01:00
2025-12-11 10:56:35 +01:00
2025-12-18 16:06:16 +01:00
2025-12-18 16:06:09 +01:00
2025-12-14 16:48:38 +01:00

Skywipe

Skywipe is a work-in-progress Python 3.13+ CLI that helps you wipe data from your Bluesky account using the AT Protocol SDK.

Warning

This tool performs destructive operations. Only use it if you intend to erase data from your Bluesky account.

Requirements

Check pyproject.toml.

You can use uv to install dependencies:

git clone https://git.kharec.info/Kharec/skywipe.git
cd skywipe
uv sync

How to run

When installation will be worked out, you'll be able to :

skywipe all            # target everything
skywipe configure      # create configuration
skywipe posts          # delete posts
skywipe medias         # delete posts with medias
skywipe likes          # undo likes
skywipe reposts        # undo reposts
skywipe quotes         # delete quotes
skywipe follows        # unfollow all
skywipe bookmarks      # delete bookmarks

While it's being developed, you can use the tool using uv :

uv run skywipe/cli.py all            # target everything
uv run skywipe/cli.py configure      # create configuration
uv run skywipe/cli.py posts          # delete posts
uv run skywipe/cli.py medias         # delete posts with medias
uv run skywipe/cli.py likes          # undo likes
uv run skywipe/cli.py reposts        # undo reposts
uv run skywipe/cli.py quotes         # delete quotes
uv run skywipe/cli.py follows        # unfollow all
uv run skywipe/cli.py bookmarks      # delete bookmarks

Configuration

If you run the tool for the first time, it will prompt you to use skywipe configure to create the configuration file, which is located in ~/.config/skywipe/config.yml :

handle: your_handle
password: your_password
batch_size: 10
delay: 1
verbose: true

BE SURE TO USE A BLUESKY APP PASSWORD FOR OBVIOUS SECURITY REASONS.

Roadmap

  • build cli parameter management
  • handle configuration logic
  • sign in to at protocol
  • delete posts in batch
  • only delete posts with media
  • undo likes
  • undo reposts
  • delete quotes
  • unfollow accounts
  • remove bookmarks
  • make all run the other commands
  • add simple progress and logging
  • add safeguards like confirmations and clear dry-run info

Once it's done, we'll think:

  • decent code architecture
  • installation and run process

License

This project is licensed under the GPLv3+ License. See the LICENSE file for details.

Description
Clean your bluesky account
Readme GPL-3.0 207 KiB
Languages
Python 100%