{"id":29427578,"url":"https://github.com/trahulsingh/green-squares-bot","last_synced_at":"2026-04-15T07:40:47.610Z","repository":{"id":301712822,"uuid":"1010095131","full_name":"TRahulsingh/green-squares-bot","owner":"TRahulsingh","description":"🔄 A GitHub Actions-powered bot that commits automatically on weekdays to keep your contribution graph active — great for learning CI/CD, Git automation, and workflow scheduling.","archived":false,"fork":false,"pushed_at":"2025-07-05T12:38:08.000Z","size":116,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-05T13:57:53.498Z","etag":null,"topics":["automation","bot","ci-cd","commit-bot","contributions","cron","daily-commit","devops","github-actions","github-workflows","green-squares","learning-project","open-source","python","scheduling","workflow"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TRahulsingh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-28T10:31:50.000Z","updated_at":"2025-07-05T12:38:12.000Z","dependencies_parsed_at":"2025-06-28T11:45:12.024Z","dependency_job_id":null,"html_url":"https://github.com/TRahulsingh/green-squares-bot","commit_stats":null,"previous_names":["trahulsingh/green-squares-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TRahulsingh/green-squares-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRahulsingh%2Fgreen-squares-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRahulsingh%2Fgreen-squares-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRahulsingh%2Fgreen-squares-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRahulsingh%2Fgreen-squares-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TRahulsingh","download_url":"https://codeload.github.com/TRahulsingh/green-squares-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRahulsingh%2Fgreen-squares-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264995886,"owners_count":23695060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bot","ci-cd","commit-bot","contributions","cron","daily-commit","devops","github-actions","github-workflows","green-squares","learning-project","open-source","python","scheduling","workflow"],"created_at":"2025-07-12T13:09:28.053Z","updated_at":"2026-04-15T07:40:47.602Z","avatar_url":"https://github.com/TRahulsingh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 🌿 green-squares-bot\n\n\u003e **A fun and educational GitHub Actions bot that automatically commits on weekdays to keep your contribution graph active.**\n\n![GitHub Workflow Status](https://img.shields.io/badge/GitHub%20Actions-Auto%20Commit%20Bot-brightgreen?logo=github)\n\n---\n\n## 💡 What is `green-squares-bot`?\n\nWelcome to **green-squares-bot** — a simple yet creative bot that automatically generates commits to make your GitHub contribution graph colorful and active 🌱.\n\nThis 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.\n\n---\n\n## ✨ Key Features\n\n- 🔁 **Automated Commits on 3–5 Random Days per Week**  \n  Each week, the bot picks 3 to 5 random days (including weekends) to commit.\n\n- 🔢 **Multiple Commits per Day**  \n  Generates between **3 to 15 commits** on each commit day, with natural variation.\n\n- 🕒 **Runs Three Times Daily**  \n  Scheduled runs spread throughout the day (Morning, Afternoon, Evening) to simulate organic activity.\n\n- 🧠 **Human-like Commit Messages and Quotes**  \n  Uses randomly selected inspirational quotes and emojis to simulate real development habits.\n\n- 📜 **Commit History Logging**  \n  Logs all commits in `commit_log.txt` for transparency and tracking.\n\n- 🧪 **Educational Use Only**  \n  Designed as a learning tool for GitHub Actions, automation, and CI/CD workflows.\n\n---\n\n## ⚙️ How It Works\n\nThis project uses a `commit.py` Python script executed through a scheduled GitHub Actions workflow (`.github/workflows/activity.yml`).\n\nThe workflow runs daily at three times:\n\n- 🌅 **Morning:** `06:00 UTC` (11:30 AM IST)  \n- 🌞 **Afternoon:** `12:00 UTC` (5:30 PM IST)  \n- 🌙 **Evening:** `15:45 UTC` (9:15 PM IST)  \n\nEach run performs:\n\n1. 🧾 Git checkout  \n2. ⚙️ Git identity setup  \n3. 🎲 Weekly randomization of 3–5 commit days  \n4. ✍️ Running `commit.py` to generate 3–15 commits on commit days  \n5. 🗂️ Updating random files with quotes and messages  \n6. 🔄 Pull latest changes with rebase  \n7. 📤 Push commits if ahead  \n\n---\n\n## 🚀 Getting Started\n\n### Clone the repo:\n\n```bash\ngit clone https://github.com/YOUR_USERNAME/green-squares-bot.git\ncd green-squares-bot\n```\n\n### Push to your own GitHub repository:\n\n```bash\ngit remote rename origin old-origin\ngit remote add origin https://github.com/YOUR_USERNAME/green-squares-bot.git\ngit push -u origin master\n```\n\nMake sure the repository is **public** so commits show up on your GitHub profile contribution graph!\n\n---\n\n## 🔧 File Structure\n\n```\ngreen-squares-bot/\n├── commit.py             # Main commit generator script\n├── daily_log.txt         # Rotating dummy file\n├── progress.md           # Rotating dummy file\n├── inspiration.txt       # Rotating dummy file\n├── commit_log.txt        # Records commit history\n└── .github/\n    └── workflows/\n        └── activity.yml  # GitHub Actions workflow\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! 🎉  \nIf you have ideas for:\n- Better commit logic  \n- Cool new features  \n- Code cleanup or optimization  \n\nFeel free to fork this repo and open a pull request.\n\n---\n\n## ⚠️ **Disclaimer**\n\n\u003e **This project is for educational and demonstration purposes only.**  \n\u003e It is designed to show how GitHub Actions can be used for scheduled automation tasks — not for inflating contributions or misleading viewers.\n\nAutomating 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:\n\n- Be **transparent** in your usage  \n- Avoid **spammy or misleading behavior**  \n- Present it clearly as a **testbed for learning automation**\n\n---\n\n🧪 Built for learning, not for production.  \n💚 Happy green squares!  \n📅 Automation starts from: `2025-07-01`\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).  \nFeel free to use, modify, and distribute it for learning and personal projects.  \nSee the full license in the [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrahulsingh%2Fgreen-squares-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrahulsingh%2Fgreen-squares-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrahulsingh%2Fgreen-squares-bot/lists"}