A very simple CLI tool for scanning your followers and ranking by your reply engagement
Add README
+59
+59
README.md
+59
README.md
···
1
+
# follow-cleaner
2
+
3
+
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.
4
+
5
+
## How it works
6
+
7
+
The tool fetches your follows and posts, then calculates an engagement score for each account you follow based on:
8
+
9
+
- **Direct replies** (+10 points): When you reply directly to someone's post
10
+
- **Thread replies** (+3 points): When you reply in a thread started by someone you follow
11
+
- **Freshness bonus** (up to +50 points): Recent follows get bonus points that decay over 25 days
12
+
13
+
Accounts with a score of 0 are ones you follow but haven't interacted with recently.
14
+
15
+
### Note
16
+
17
+
It does **NOT** weigh likes. If you only like posts, you might see a zero.
18
+
19
+
## Installation
20
+
21
+
```sh
22
+
bun install
23
+
```
24
+
25
+
## Usage
26
+
27
+
```sh
28
+
bun index.ts <handle>
29
+
```
30
+
31
+
For example:
32
+
33
+
```sh
34
+
bun index.ts user.bsky.social
35
+
```
36
+
37
+
The tool will output:
38
+
39
+
- Progress logs as it fetches data from the Bluesky API
40
+
- A summary of your top 5 highest-scored follows
41
+
- A count of accounts with zero engagement
42
+
- A file named `<handle>_engagement.txt` with all scores sorted from highest to lowest
43
+
44
+
## Output format
45
+
46
+
The output file contains one line per followed account:
47
+
48
+
```
49
+
handle.bsky.social 63 (engagement: 30, freshness: 33)
50
+
another.user 10 (engagement: 10, freshness: 0)
51
+
old.follow 0 (engagement: 0, freshness: 0)
52
+
```
53
+
54
+
## Requirements
55
+
56
+
- [Bun](https://bun.sh) runtime
57
+
- No authentication required (uses public Bluesky API)
58
+
59
+
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.