Skip to content

Releases: lancedesk/github-unfollower

v2.1.1 - Fully Non-Interactive Mode

04 Feb 09:44

Choose a tag to compare

Bug Fix: Complete Automation Support

What's Fixed

The -y flag now properly skips ALL prompts, not just token confirmation.

Before v2.1.1:

$ followers 9 -y
✓ Using existing token (auto-confirmed)
Dry run first? (y/n):  # Still prompted! ❌

After v2.1.1:

$ followers 9 -y
✓ Using existing token (auto-confirmed)
✓ Auto-executing (no dry-run)  # No prompt! ✅

Changes

  • Option 3 (bulk unfollow): -y skips dry-run prompt
  • Option 5 (bulk follow): -y skips dry-run prompt
  • Option 9 (auto-sync): -y skips dry-run prompt
  • Help text updated: "Auto-accept all prompts"
  • README clarified behavior

Now Fully Supports

Cron Jobs:

# Daily auto-sync at 2 AM
0 2 * * * followers 9 -y >> ~/followers-log.txt 2>&1

Automation Scripts:

followers 9 -y  # Completely unattended

CI/CD Pipelines:

- run: followers 3 -y  # No interaction needed

Upgrading from v2.1.0

cd github-unfollower
git pull
# Your existing scripts with -y will now work as expected

This completes the automation features started in v2.1.0.

v2.1.0 - Command-Line Arguments

04 Feb 09:39

Choose a tag to compare

Command-Line Arguments Support

What's New

  • Direct Command Execution: Run specific options without interactive menu
  • Auto-Confirm Flag (-y): Skip token confirmation for automation
  • Help Flag (-h): Quick reference for all available commands
  • Flexible Argument Order: Mix flags and commands however you prefer

New Command Syntax

# Direct option execution
followers 9              # Run auto-sync (will ask about token)
followers 9 -y           # Run auto-sync, auto-confirm token

# Show information
followers 1              # Show non-followers
followers 6              # Check rate limit status

# Arguments work in any order
followers -y 3           # Same as: followers 3 -y
followers --help         # Show usage guide

Use Cases

Automation & Scripting:

# Cron job for daily auto-sync
0 2 * * * followers 9 -y

# Quick status check
followers 6 -y

Quick Operations:

# Check who doesn't follow back
followers 1

# Bulk unfollow non-followers
followers 3 -y

CI/CD Integration:

# No interactive prompts
followers 9 -y

Available Commands

Command Description
1 Show who you follow but they don't follow back
2 Show your followers you don't follow back
3 Unfollow users who don't follow you back (bulk)
4 Unfollow users (selective - choose each)
5 Follow back your followers (bulk)
6 Show rate limit status
7 Change GitHub token
8 Debug: Show counts
9 Auto-sync: Unfollow non-followers + Follow back
0 Exit

Command-Line Flags

Flag Description
-y, --yes Auto-accept existing token (no prompt)
-h, --help Show help message with examples

Backward Compatibility

  • No arguments: Interactive mode (same as v2.0.0 and v1.0.0)
  • All existing functionality preserved
  • Zero breaking changes

Installation

git clone https://github.com/lancedesk/github-unfollower.git
cd github-unfollower
chmod +x gh-followers.sh install.sh
./install.sh  # Optional global installation

Upgrading from v2.0.0 or v1.0.0

cd github-unfollower
git pull
# Your token and settings are preserved
# New command-line features available immediately

See README.md for full documentation.

v2.0.0 - Auto-Sync Feature

30 Jan 15:11

Choose a tag to compare

Auto-Sync Feature Release

What's New

  • Auto-Sync Mode (Option 9): Combines unfollow non-followers and follow back operations into one automated workflow
  • Comprehensive Progress Tracking: Real-time progress for both unfollow and follow operations
  • Detailed Reporting: Summary of actions taken after each step
  • Dry-Run Support: Preview changes before execution with option to execute afterward
  • Menu Reorganization: Option 9 = Auto-sync, Option 0 = Exit

Auto-Sync Workflow

  1. Fetches follower/following data once
  2. Unfollows users who don't follow you back (with progress)
  3. Reports unfollowed users count
  4. Follows back all your followers (with progress)
  5. Reports followed users count
  6. Provides final summary

Example Output

STEP 1: Unfollowing Non-Followers
Found 5 users to unfollow
Progress: 5/5
✓ Unfollowed 5 users

STEP 2: Following Back Your Followers
Found 3 users to follow back
Progress: 3/3
✓ Followed back 3 users

SYNC COMPLETE
- Unfollowed: 5 users
- Followed: 3 users

Improvements

  • Maintains backward compatibility with v1.0.0
  • Efficient single data fetch reduces API calls
  • Smart refresh of following list between operations

Installation

git clone https://github.com/lancedesk/github-unfollower.git
cd github-unfollower
chmod +x gh-followers.sh install.sh
./install.sh  # Optional global installation

Upgrading from v1.0.0

cd github-unfollower
git pull
# Your token and settings are preserved

See README.md for full documentation.

v1.0.0 - Initial Stable Release

30 Jan 15:10

Choose a tag to compare

Initial Stable Release

Features

  • View users who don't follow you back
  • View followers you haven't followed back
  • Bulk unfollow non-followers with dry-run support
  • Selective unfollow (review each user)
  • Bulk follow back your followers
  • Rate limit status monitoring
  • Token management and persistence
  • Debug mode with counts and statistics
  • Cross-platform support (Windows/macOS/Linux)
  • Automatic jq installation on Windows via Scoop
  • Global installation support via install.sh
  • Comprehensive logging

Platform Support

  • Windows (Git Bash)
  • macOS
  • Linux

Security

  • Secure token storage with restricted permissions
  • .gitignore prevents accidental token commits

Installation

git clone https://github.com/lancedesk/github-unfollower.git
cd github-unfollower
chmod +x gh-followers.sh install.sh
./install.sh  # Optional global installation

See README.md for full documentation.