life-clock

⏳ "See how far you've come. And how far to go."

life-clock is a simple CLI tool that visualizes the progress of your life based on your birthdate — with a clean progress bar and motivational insights. It's a fun and reflective way to stay mindful of time.

Whether you're planning your next big project or just need a gentle reminder to live intentionally, life-clock turns your terminal into a philosophical time tracker.

Ouput

🎉 You're 29 years old
🧬 Estimated lifespan: 79 years
📊 Progress: 36.7% of life lived

███████████░░░░░░░░░░░░░░░░░░  36.7%

💡 Make it count. Start something today.

Why This Exists

Time is our most valuable asset — and most of us forget how little we have. life-clock is a gentle, visual nudge to make every day matter. Inspired by Tim Urban's "Life in Weeks" and the Stoic idea of memento mori.

✨ Features

• 🔢 Calculates exact age in years
• 🟦 Displays life progress bar (customizable width)
• 📅 Assumes average life expectancy (default 79 years, override with flag)
• 💡 Shows random motivational quote (with support for custom quotes)
• 🔄 Option to show only once per day (perfect for .bashrc or .zshrc)

📦 Installation

# Install globally
npm install -g life-clock

# Or run directly with npx
npx life-clock

🚀 Usage

# Basic usage (will prompt for birthdate)
life-clock

# Provide birthdate directly (two equivalent options)
life-clock --birthdate 1990-01-01
life-clock --dob 1990-01-01

# Customize life expectancy (default: 79)
life-clock --dob 1990-01-01 --expectancy 85

# Customize progress bar width (default: 30)
life-clock --dob 1990-01-01 --width 40

# Change progress bar position to top
life-clock --dob 1990-01-01 --bar-position top

# Show only once per day (great for .bashrc or .zshrc)
life-clock --dob 1990-01-01 --daily

# Add a custom motivational quote
life-clock --add-quote "Every day is a new opportunity to change your life."

# List all your saved quotes
life-clock --list-quotes

🔧 Options

-b, --birthdate <date>       Your birthdate in YYYY-MM-DD format
-d, --dob <date>             Your date of birth in YYYY-MM-DD format (alias for --birthdate)
-e, --expectancy <years>     Life expectancy in years (default: 79)
-w, --width <characters>     Width of the progress bar (default: 30)
--daily                      Show only once per day (great for .bashrc or .zshrc)
--add-quote <quote>          Add a custom motivational quote to your collection
--list-quotes                List all quotes in your collection
--reset-quotes               Reset quotes collection to default quotes
--bar-position <position>    Position of the progress bar (top or default; default: default)
-V, --version                Output the version number
-h, --help                   Display help for command

🔄 Daily Reminder

Add to your shell profile for a daily reminder of life's progress:

# Add to your .bashrc, .zshrc, or equivalent
life-clock --dob 1997-03-14 --daily

💬 Custom Quotes

You can add your own motivational quotes to personalize your experience:

# Add a custom quote
life-clock --add-quote "Your time is limited, don't waste it living someone else's life."

# View all your quotes
life-clock --list-quotes

# Reset to default quotes
life-clock --reset-quotes

Your quotes are stored in ~/.life-clock/quotes.json and will be randomly displayed each time you run the tool. If you don't add any custom quotes, the tool will use its built-in collection of motivational quotes.

🤝 Contributing

Contributions, issues, and feature requests are welcome!