CLI tool that visualizes the progress of your life based on your birthdate with a clean progress bar and motivational insights
npm install life-clocklife-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.
``
š You're 29 years old
𧬠Estimated lifespan: 79 years
š Progress: 36.7% of life lived
āāāāāāāāāāāāāāāāāāāāāāāāāāāāā 36.7%
š” Make it count. Start something today.
`
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.
- š¢ 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)
`bashInstall globally
npm install -g life-clock
š Usage
`bash
Basic usage (will prompt for birthdate)
life-clockProvide birthdate directly (two equivalent options)
life-clock --birthdate 1990-01-01
life-clock --dob 1990-01-01Customize life expectancy (default: 79)
life-clock --dob 1990-01-01 --expectancy 85Customize progress bar width (default: 30)
life-clock --dob 1990-01-01 --width 40Change progress bar position to top
life-clock --dob 1990-01-01 --bar-position topShow only once per day (great for .bashrc or .zshrc)
life-clock --dob 1990-01-01 --dailyAdd 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 Your birthdate in YYYY-MM-DD format
-d, --dob Your date of birth in YYYY-MM-DD format (alias for --birthdate)
-e, --expectancy Life expectancy in years (default: 79)
-w, --width Width of the progress bar (default: 30)
--daily Show only once per day (great for .bashrc or .zshrc)
--add-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 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:
`bash
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:
`bash
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-quotesReset 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.Contributions, issues, and feature requests are welcome!