GitHub Follow Helper

Automate your GitHub networking with bulk follow/unfollow operations

Installation • Setup • Usage • Troubleshooting

---

✨ Features

Feature	Description
🤖 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

Prerequisites

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

From Source (Development)

1. Clone the repository

   git clone https://github.com/your-username/auto-follow-extension.git
   cd auto-follow-extension

2. Load the extension in Chrome

   • Open Chrome and navigate to chrome://extensions/
   • Enable "Developer mode" in the top right
   • Click "Load unpacked" and select the extension folder
   • The extension will appear in your Chrome toolbar

🔧 Setup

Step 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)

Step 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)

📖 Usage

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

Aspect	Details
Token Storage	Your GitHub token is stored locally in your browser's localStorage
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

Method	Endpoint	Description
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.

Development Setup

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 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! 🚀

Made with Kitty for the GitHub community