DEV Community

Cover image for πŸŒ€ The Ritual Scheduler
Ashley B
Ashley B

Posted on

πŸŒ€ The Ritual Scheduler

β€œSummon a daily contribution. Maintain the illusion. Worship the green.”


You ever stare at your GitHub contribution graph like it's a Tamagotchi you forgot to feed?

Yeah, me too.

So I built something unholy:

A Bash-based automation daemon that ensures your GitHub profile always looks... alive.

It commits. It pushes. It even wakes your computer from the dead to do it.


✨ Features

  • ⏰ Schedules fake-but-believable commits at randomized human hours
  • πŸ” Retries if GitHub rejects your offering
  • πŸ’Ύ Logs your ritual attempts and successes
  • 🌴 Vacation mode, so your ritual pauses when you need rest (or alibis)
  • πŸ”₯ Self-healing if a ritual was missed (triggered by guilt and grep)
  • πŸ‘οΈ macOS popup warnings like: > β€œβš οΈ No ritual detected today. The square is empty. You are exposed.”

πŸŽ›οΈ Customization Options

  • πŸ§™ Choose your commit incantations like:
    • feat: added function nobody asked for
    • fix: removed existential crisis from variable name
  • πŸ“œ Add custom altar messages
  • πŸ”“ Unlock rare achievements like:
    • "100 Days of Devotion"
    • "The Sacred Streak"

πŸ“¦ What's Included?

  • βœ… Daily ritual cron + safety check daemon
  • πŸͺž GitHub visibility flip (goes public, commits, hides again)
  • πŸ§™β€β™€οΈ Bash installer with prompt-based setup
  • πŸ•οΈ Vacation flag toggle for burnout mercy
  • 🧾 .command launcher for double-click ritualism
  • 🎨 Coming Soon:
    • SVG badges
    • GitHub profile theme pack
    • Guilt Daemonβ„’ (shames you in Slack when your squares go dark)

❓ Joke or Real Tool?

Yes.

I built it for fun. I also use it daily.

It’s part spiritual theater, part productivity placebo, and part real automation.


πŸ›  Tech Stack

  • Bash
  • cron, pmset, at, and osascript (macOS)
  • GitHub CLI (gh)
  • Dark magic

πŸ§ͺ Want to Try It?

I'm testing the waters. If enough devs want this, I’ll clean it up, ship a proper version, maybe even add a front-end GUI (Tauri? React? Electron? We’ll see).

Leave a comment if you'd actually use it β€” or just want the GitHub link.


β€œCoding is a ritual. This just makes it official.”

Top comments (2)

Collapse
 
ibi_66 profile image
ibrahim

github link please

Collapse
 
ashb4 profile image
Ashley B • Edited

Hey! Appreciate the interest πŸ™Œ

My GitHub is github.com/AshB4 if you wanna check out other dev projects.

I don’t make the Ritual Scheduler repo public β€” but I do offer the full shell script stack (manual setup for now, automation coming soon) with stealth mode, randomized commit windows, vacation toggles, and more.

If you're curious where the idea started, this PowerShell101 repo holds some of the early automation thinking:
πŸ‘‰ github.com/AshB4/POWERSHELL101

And if you're ready to skip the setup and just let it run:
πŸ‘‰ fleurdevie.gumroad.com/l/github-streak-shell-script?utm_source=devto&utm_medium=comment&utm_campaign=ritual_scheduler β€” no fluff, just silent output.