🌿 green-squares-bot

A fun and educational GitHub Actions bot that automatically commits on weekdays to keep your contribution graph active.

---

💡 What is green-squares-bot?

Welcome to green-squares-bot — a simple yet creative bot that automatically generates commits to make your GitHub contribution graph colorful and active 🌱.

This is a demo project that showcases how you can use GitHub Actions to automate routine tasks, like generating commits on a schedule. It’s a great way to explore GitHub automation, scheduled workflows (via CRON), and Git operations — all within a lightweight and transparent project.

---

✨ Key Features

• 🔁 Automated Commits
  Generates between 3–15 commits per weekday (Mon–Sat) with natural variability

• 🕒 Multiple Time Slots
  Runs three times daily (Morning, Afternoon, Evening) to spread activity

• 🧠 Human-like Commit Messages
  Each commit includes random quotes, emojis, or messages to simulate real development

• 📜 Commit Logging
  Tracks all commits in commit_log.txt for transparency

• 🧪 Educational Purpose Only
  Intended as a sandbox for learning about GitHub Actions and CI/CD workflows

---

⚙️ How It Works

This project uses a commit.py Python script and a scheduled GitHub Actions workflow (.github/workflows/activity.yml).

The workflow runs on:

• Morning: 06:00 UTC (11:30 AM IST)
• Afternoon: 12:00 UTC (5:30 PM IST)
• Evening: 15:45 UTC (9:15 PM IST)

Each run performs:

1. 🧾 Git checkout
2. ⚙️ Git identity setup
3. 📄 Running commit.py to generate 1–5 commits
4. 🗂️ Random file updates
5. 📤 Git push

---

🚀 Getting Started

Clone the repo:

git clone https://github.com/YOUR_USERNAME/green-squares-bot.git
cd green-squares-bot

Push to your own GitHub repository:

git remote rename origin old-origin
git remote add origin https://github.com/YOUR_USERNAME/green-squares-bot.git
git push -u origin master

Make sure the repository is public so commits show up on your GitHub profile contribution graph!

---

🔧 File Structure

green-squares-bot/
├── commit.py             # Main commit generator script
├── daily_log.txt         # Rotating dummy file
├── progress.md           # Rotating dummy file
├── inspiration.txt       # Rotating dummy file
├── commit_log.txt        # Records commit history
└── .github/
    └── workflows/
        └── activity.yml  # GitHub Actions workflow

---

🤝 Contributing

Contributions are welcome! 🎉
If you have ideas for:

• Better commit logic
• Cool new features
• Code cleanup or optimization

Feel free to fork this repo and open a pull request.

---

⚠️ Disclaimer

This project is for educational and demonstration purposes only.
It is designed to show how GitHub Actions can be used for scheduled automation tasks — not for inflating contributions or misleading viewers.

Automating your GitHub activity can be a fun and informative way to learn about CI/CD, bots, scripting, and workflows — but it's important to use this responsibly:

• Be transparent in your usage
• Avoid spammy or misleading behavior
• Present it clearly as a testbed for learning automation

---

🧪 Built for learning, not for production.
💚 Happy green squares!
📅 Automation starts from: 2025-07-01

---

📄 License

This project is licensed under the MIT License.
Feel free to use, modify, and distribute it for learning and personal projects.
See the full license in the LICENSE file.