# Unfollow Management

> Mass unfollow on X/Twitter via browser console scripts. Unfollows everyone, only non-followers, non-followers with username logging, smart time-based unfollow with whitelists, and follow/following ratio management. Use when cleaning up a following list, removing non-followers, bulk unfollowing accounts, or optimizing your follow ratio.

- Skill: `nirholas/unfollow-management` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nirholas/unfollow-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nirholas/unfollow-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: nirholas (https://skillmd.com/u/nirholas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nirholas/unfollow-management

---


# Unfollow Management

Browser console scripts for managing who you follow on X/Twitter. All scripts run in DevTools console.

## Script Selection

| Goal | File | Navigate to |
|------|------|-------------|
| Unfollow ALL accounts | `src/unfollowEveryone.js` | `x.com/USERNAME/following` |
| Unfollow only non-followers | `src/unfollowback.js` | `x.com/USERNAME/following` |
| Unfollow non-followers + download log | `src/unfollowWDFBLog.js` | `x.com/USERNAME/following` |
| Time-based smart unfollow with whitelist | `src/automation/smartUnfollow.js` | `x.com/USERNAME/following` |
| Detect who unfollowed you | `src/detectUnfollowers.js` | `x.com/USERNAME/followers` |
| Monitor follow/following ratio + plan | `src/followRatioManager.js` | `x.com/USERNAME` |
| Remove specific followers from YOUR list | `src/removeFollowers.js` | `x.com/USERNAME/followers` |

## Script Details

For detailed algorithms, controls, configurations, and DOM selectors for each script, see [references/script-details.md](references/script-details.md).

## Rate Limiting & Safety

- **Default delay:** 1–2 seconds between unfollows (gaussian randomized)
- **Batch delay:** 2–3 seconds between scroll batches
- **Rate limit detection:** Scripts check for `[data-testid="toast"]` warning banners
- **Backoff:** If rate limited, scripts wait 30–60 seconds before retrying
- **Daily limit guidance:** X may restrict after ~400 unfollows/day; spread over multiple sessions
- **Recovery:** If action-restricted, wait 12–24 hours

## Strategy Guide

### Cleaning a bloated following list

1. Run `src/followRatioManager.js` on your profile to assess current ratio
2. Use `XActions.plan()` to see how many unfollows are needed
3. Run `src/unfollowback.js` to remove non-followers first (safest)
4. If more cleanup needed, use `src/unfollowEveryone.js` with abort when satisfied
5. Re-check ratio with `XActions.track()`

### Maintaining a healthy ratio over time

1. Set up periodic runs of `src/detectUnfollowers.js` to track losses
2. Use `src/followRatioManager.js` weekly to monitor trends
3. Run `src/unfollowback.js` monthly to remove non-reciprocal follows
4. Keep a whitelist in `smartUnfollow.js` for accounts you always want to follow

### Before a big unfollow session

1. Export your following list first: `scripts/scrapeFollowing.js`
2. Run `src/unfollowWDFBLog.js` (saves log of who was unfollowed)
3. Review the downloaded log for any mistakes
4. Use `src/followRatioManager.js` to verify improvements

## Troubleshooting

| Problem | Solution |
|---------|----------|
| "No unfollow buttons found" | Make sure you're on the Following page, not Followers |
| Script stops after ~20 unfollows | X rate limit triggered — wait 1 hour and re-run |
| Confirmation dialog doesn't appear | DOM may have changed — check `confirmationSheetConfirm` selector |
| Script unfollows mutuals | Use `unfollowback.js` instead of `unfollowEveryone.js` |
| "Action restricted" warning | Account is temporarily limited — wait 12-24 hours |
| Script misses accounts | Re-run the script — some load below the scroll area |

## Related Skills

- **follower-monitoring** — Track follower growth and detect unfollowers
- **blocking-muting-management** — Block/unblock for removing followers
- **growth-automation** — Grow followers to improve ratio organically
- **analytics-insights** — Understand engagement before unfollowing