GitHub Follow Helper

A Chrome extension that helps you efficiently manage your GitHub follows and unfollows with automated bulk operations.

🚀 Features

• Automated Following: Bulk follow users from GitHub pages with a single click
• Automated Unfollowing: Easily unfollow multiple users at once
• Token Persistence: Save your GitHub Personal Access Token for continuous use
• Smart User Detection: Automatically detects users available to follow on GitHub pages
• Dual Tab Interface: Separate tabs for following and unfollowing operations
• Visual Feedback: Success animations and real-time status updates
• Safe API Usage: Built-in delays to respect GitHub's rate limits

📦 Installation

From Source (Development)

1. Clone or download this repository
2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" in the top right
4. Click "Load unpacked" and select the extension folder
5. The extension will appear in your Chrome toolbar

Prerequisites

• Chrome browser (version 88+)
• GitHub Personal Access Token with appropriate permissions

🔧 Setup

1. Get Your GitHub Personal Access Token

1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Click "Generate new token (classic)"
3. Give it a descriptive name (e.g., "Follow Helper")
4. Select the following scopes:
   • user:follow - Follow and unfollow users
   • read:user - Read user information
5. Click "Generate token"
6. Important: Copy the token immediately (you won't see it again)

2. Configure the Extension

1. Click the extension icon in your Chrome toolbar
2. Paste your GitHub Personal Access Token
3. Click "Save Token" (it will be remembered for future use)

📖 How to Use

Following Users

1. Navigate to any GitHub page with user profiles (e.g., followers, following, or search results)
2. Click the extension icon
3. The "Follow" tab will show users available to follow
4. Select users you want to follow (or click "Select All")
5. Click "Auto Follow"
6. Watch as users are followed automatically with visual feedback

Unfollowing Users

1. Click the extension icon
2. Switch to the "Unfollow" tab
3. The extension will fetch your currently followed users
4. Select users you want to unfollow (or click "Select All")
5. Click "Auto Unfollow"
6. Users will be unfollowed with success animations

🛡️ Security & Privacy

• Token Storage: Your GitHub token is stored locally in your browser's localStorage
• No Data Collection: The extension doesn't collect or transmit any personal data
• API Compliance: Uses GitHub's official API with proper authentication
• Rate Limiting: Built-in delays to respect GitHub's API limits

🔧 Technical Details

API Endpoints Used

• GET /user/following - Fetch followed users
• PUT /user/following/{username} - Follow a user
• DELETE /user/following/{username} - Unfollow a user

Permissions Required

• activeTab - To access the current GitHub page
• storage - To save your GitHub token locally
• https://api.github.com/* - To interact with GitHub's API

Rate Limiting

• 700ms delay between API calls to respect GitHub's rate limits
• Automatic retry logic for failed requests
• Visual feedback for successful operations

🐛 Troubleshooting

Common Issues

"Please save your GitHub token first!"

• Make sure you've entered and saved your GitHub Personal Access Token
• Verify the token has the correct permissions

"Error loading users"

• Ensure you're on a GitHub page with user profiles
• Check your internet connection
• Verify your GitHub token is valid

"Error loading followed users"

• Check that your GitHub token has the user:follow permission
• Ensure your token hasn't expired
• Verify you have an active internet connection

Token Issues

If you're having trouble with your token:

1. Go to GitHub Settings → Developer settings → Personal access tokens
2. Check if your token is still active
3. Verify it has the required permissions
4. Generate a new token if necessary

📝 Changelog

Version 1.0.0

• Initial release
• Automated following functionality
• Automated unfollowing functionality
• Token persistence
• Dual tab interface
• Visual feedback and animations

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

This extension is for personal use and educational purposes. Please use responsibly and in accordance with GitHub's Terms of Service. The developers are not responsible for any misuse of this tool.

🆘 Support

If you encounter any issues or have questions:

1. Check the troubleshooting section above
2. Open an issue on GitHub
3. Ensure you're using the latest version of the extension

---

Happy GitHub networking! 🚀