follow-cleaner#
A CLI tool that analyzes your Bluesky follow list and scores accounts based on how much you interact with them. Useful for identifying accounts you might want to unfollow.
How it works#
The tool fetches your follows and posts, then calculates an engagement score for each account you follow based on:
- Direct replies (+10 points): When you reply directly to someone's post
- Thread replies (+3 points): When you reply in a thread started by someone you follow
- Freshness bonus (up to +50 points): Recent follows get bonus points that decay over 25 days
Accounts with a score of 0 are ones you follow but haven't interacted with recently.
Note#
It does NOT weigh likes. If you only like posts, you might see a zero.
Installation#
bun install
Usage#
bun index.ts <handle>
For example:
bun index.ts user.bsky.social
The tool will output:
- Progress logs as it fetches data from the Bluesky API
- A summary of your top 5 highest-scored follows
- A count of accounts with zero engagement
- A file named
<handle>_engagement.txtwith all scores sorted from highest to lowest
Output format#
The output file contains one line per followed account:
handle.bsky.social 63 (engagement: 30, freshness: 33)
another.user 10 (engagement: 10, freshness: 0)
old.follow 0 (engagement: 0, freshness: 0)
Requirements#
- Bun runtime
- No authentication required (uses public Bluesky API)
Code and most of README slopped out, sorry if that hurts your feelings. Not burning energy on tiny little tools like this that are not logically complex but are a time sink.