A very simple CLI tool for scanning your followers and ranking by your reply engagement
7
fork

Configure Feed

Select the types of activity you want to include in your feed.

TypeScript 100.0%
5 1 0

Clone this repository

https://tangled.org/woovie.net/follow-cleaner https://tangled.org/did:plc:wh2g32kxs6xgduoibqdpne5j/follow-cleaner
git@tangled.org:woovie.net/follow-cleaner git@tangled.org:did:plc:wh2g32kxs6xgduoibqdpne5j/follow-cleaner

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

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.txt with 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.