🔥 streak-cli

Track your terminal work streaks, commits, and stats. Stay motivated with daily streak tracking right in your terminal.

  🔥 5 day streak! 🔥

  ─────────────────────────────
  🔥 Current streak:    5 days
  🏆 Longest streak:   23 days
  📅 Total active days: 142
  ─────────────────────────────
  💻 Commits today:     12
  📝 Total commits:     847
  ⌨️  Commands today:    87
  ─────────────────────────────

  Mon Tue Wed Thu Fri Sat Sun
  ✅  ✅  ✅  ✅  ✅  🔲  🔲

Install

npm install -g streak-cli
streak setup

streak setup automatically:

• Adds a shell hook to ~/.zshrc for auto-tracking
• Adds a 🔥 streak counter to your prompt (if you use Powerlevel10k)

Then restart your terminal or run source ~/.zshrc.

Usage

streak            # Show your current streak & stats
streak stats      # Same as above (detailed view)
streak log        # Log activity (done automatically by shell hook)
streak setup      # Install shell hook + prompt segment
streak reset      # Clear all data
streak help       # Show help

Prompt Integration

If you use Powerlevel10k, streak setup adds a 🔥 segment to your prompt automatically:

~/projects/myapp  on main  🔥5

How It Works

• Every command you run gets logged via a precmd shell hook
• Git commits in the current repo are counted
• A "day" counts as active if you ran any commands or made commits
• Streaks are consecutive active days

Data

All data is stored locally in ~/.streak/:

• activity.json — daily activity log
• current_streak — cached streak count (used by prompt)

No data is sent anywhere. Everything stays on your machine.

Uninstall

npm uninstall -g streak-cli

Remove the hook from ~/.zshrc and the segment from ~/.p10k.zsh (search for "Streak CLI").

License

ISC