🤖 Auto Commit Bot

🚀 Keep your GitHub contribution graph active with daily motivational commits

📚 Table of Contents

• 🌟 Features
• 🚀 Getting Started
• ⚙️ Configuration
• 📊 Understanding the Output
• 🎮 Interactive Usage
• 👨‍💻 Author

🌟 Features

Click to expand/collapse

• ⏰ Automated daily commits - Keeps your GitHub activity green
• 💬 Random inspirational quotes - Stay motivated with a new quote every day
• 😄 Random emojis - Adds fun visual elements to your commits
• 📈 Progress tracking - Counts and tracks your commit streak
• 🏆 Milestone summaries - Special files created every 10th commit to celebrate progress
• 📅 Weekly summaries - Added to your log every 7th commit
• 🎮 Interactive manual triggers - Run the workflow on-demand with custom messages
• 🔄 Smart log rotation - Automatically archives logs when they get too large

🚀 Getting Started

Click to expand/collapse

Prerequisites

• A GitHub account
• A personal access token (PAT) with repo scope

Setup Instructions

1. Fork or clone this repository

2. Set up the PAT_TOKEN secret

   Repository Settings → Secrets → Actions → New Repository Secret
   Name: PAT_TOKEN
   Value: [your personal access token]
   

3. Enable the workflow

   Actions tab → "I understand my workflows, go ahead and enable them"
   

4. Set up the USERNAME / EMAIL secret

   name: Setup Git
        run: |
          git config user.name "goutham-shankar"
          git config user.email "gouthamsankarv@gmail.com"
   

5. First run

   • Manually trigger your first run by clicking "Run workflow"
   • The bot will create your first commit and start tracking!

6. Sit back and watch

   • The bot will now commit daily at 07:00 UTC
   • Your GitHub contribution graph will stay active!

⚙️ Configuration

Click to expand/collapse

Schedule

The bot is configured to run daily at 07:00 UTC. To change this schedule, edit the cron expression in .github/workflows/auto-commit.yml:

on:
  schedule:
    - cron: '0 7 * * *'  # Format: minute hour day_month month day_week

Manual Trigger Options

When manually triggering the workflow, you can customize:

Option	Description
Custom message	Add a personal note to your commit
Skip quote	Choose not to include a motivational quote
Extra emoji	Specify a custom emoji instead of using a random one

Customizing Quotes and Emojis

To add your own inspirational quotes or favorite emojis, edit these arrays in the workflow file:

EMOJIS=("🎯" "🔥" "💪" "📅" "🧠" "🚀" "💻" "✅" "🌟" "⚡" "🏆" "🔄" "🌈" "🎨" "📊" "🔍")
QUOTES=(
  "Push yourself, because no one else is going to do it for you."
  "Stay positive, work hard, make it happen."
  # Add your favorite quotes here!
)

📊 Understanding the Output

Click to expand/collapse

Commit Log Format

Each entry in your commit_log.txt will look like:

42. 🚀 Commit on 2025-06-14 08:55:55 (Saturday): Success doesn't just find you. You have to go out and get it.

Weekly Summaries

Every 7th commit adds a weekly summary to your log:

---- Weekly Summary (Commit #7) ----
✨ Total commits this week: 7
📆 Days left in year: 200
🎯 Keep the streak going!
-----------------------------------

Milestone Summaries

Every 10th commit creates a special markdown file (milestone_summary_XX.md) that contains:

• A congratulatory header
• Current statistics (date, time, day of week)
• Recent commit history

Example milestone summary:

# Milestone Reached: Commit #50 🎉

Congratulations on reaching 50 daily commits!

## Stats
- Date: 2025-06-14
- Time: 08:55:55
- Day of week: Saturday
- Days left in year: 200

## Recent Commits
[Last 10 entries from your commit_log.txt]

🎮 Interactive Usage

Click to expand/collapse

Manual Trigger

To manually trigger a commit:

1. Go to the Actions tab in your repository
2. Select the Auto Commit workflow
3. Click Run workflow
4. (Optional) Fill in the custom options:
   • Add a custom message
   • Choose a specific emoji
   • Opt to skip the motivational quote

Example Custom Commits

Purpose	Custom Message	Emoji	Result
Celebrate	Reached 1000 stars!	🎉	chore: 🎉 Auto commit #42 - Reached 1000 stars! (manual trigger)
Project update	Updated Node.js version	📦	chore: 📦 Auto commit #43 - Updated Node.js version (manual trigger)
Daily reminder	Remember to update docs	📝	chore: 📝 Auto commit #44 - Remember to update docs (manual trigger)

👨‍💻 Author

Goutham Shankar

Stay committed to your goals, one auto-commit at a time.