v1.0.0

🎉 Initial Release: v1.0.0

Welcome to the first public release of the GitHub Contributor Bot!

This project was built from the ground up in Go to solve a major problem with existing contribution generators: they look like bots. This tool is designed to produce a commit history that is completely indistinguishable from a real, human developer, all while running entirely hands-free.

✨ Extreme Realism Features

• Randomized Timestamps: Even though the GitHub Action triggers at midnight, commits are intelligently backdated to random times during normal working hours (9 AM to 10 PM).
• Rest Days (15%): Real developers take breaks. The bot has a 15% chance to completely skip a day to maintain an organic-looking graph.
• Sprint Days (10%): Occasionally, the bot goes into overdrive, dynamically exceeding your max-commits limit to simulate a highly productive coding sprint.
• Work-Life Balance: Optional --skip-weekends flag if you want the "corporate developer" look (commits only Monday–Friday).
• Dynamic Branching: 20% of the time, the bot creates a realistic feature or bugfix branch, commits to it, and merges it back into main with a non-fast-forward commit.
• Multi-File Modifications: Instead of updating a single dummy file, the bot modifies a variety of realistic files (logs/debug.log, scripts/build.sh, config/settings.json, etc.) isolated safely in a bot-data/ directory.

📚 Massive Customization

• Huge Built-in Pools: Ships out of the box with ~200 realistic commit messages (across 16 categories like DevOps, Security, UI, Refactoring) and ~200 realistic branch names.
• Bring Your Own Messages: Use messages.txt and branch_names.txt to inject your own project-specific names. You can choose to append them to the built-in pool for maximum variety, or replace the pool entirely.
• Zero CLI Flags Required: Configure your preferences once in bot.config.json and never touch a command line flag again.

🛠️ Developer Experience & Reliability

• Blazing Fast & Zero Dependencies: Written entirely in Go standard library. Starts up in milliseconds and uses <10MB of memory.
• Dry-Run Mode (-dry-run): Safely preview exactly what the bot would do (timestamps, branches, messages) without executing any git commands or modifying files.
• Git Retry Logic: Built-in network resilience. If GitHub drops a connection during a push, the bot retries up to 3 times with exponential backoff to ensure your streak is never broken.
• Stats Tracking: Automatically tracks your all-time runs, total commits, rest days, sprint days, and branches used in a local stats.json file.
• Anonymous Commits: The GitHub Action dynamically uses GitHub's official noreply email system. Your commits count towards your graph, but your personal email address remains 100% hidden from scrapers.

📦 Two Modes Included

1. daily: The smart, randomized engine designed to run daily via GitHub Actions to maintain your current streak.
2. spam: A dedicated CLI tool to instantly generate hundreds of backdated commits spread over the last year to fill in historical gaps in your graph.

⬇️ Installation

No Go installation required! Download the pre-built binary for your operating system (Linux, macOS, Windows) from the assets below, or just fork the repository to get the automated GitHub Action running instantly.