Streak Tracker CLI

Generate a calendar-correct streak tracker .xlsx and .pdf from the bundled Streak Tracker.xlsx template.

Requirements

• Node.js 18+
• LibreOffice available in PATH

Install

Local development:

npm install

Run directly:

node ./bin/streak-tracker.js --help

Install as a global CLI from npm later:

npm install -g streak-tracker-cli
streak-tracker --help

Or run without installing globally:

npx streak-tracker-cli --help

Usage

Generate a full month:

streak-tracker --month 2025-06

Generate a 30-day streak starting from today:

streak-tracker --current

Generate a custom streak from a start date:

streak-tracker --start-date 2025-01-30 --days 30

Optional flags:

streak-tracker \
  --month 2025-06 \
  --output-dir ./files \
  --name june-streak

Output

By default, files are written to ./output relative to the directory where the command is run.

Examples:

• running from ~/Desktop saves to ~/Desktop/output
• --output-dir ./files saves to ./files

The CLI prints the final paths for:

• <name>.xlsx
• <name>.pdf

Publish to npm

1. Pick the final package name in package.json
2. Log in with npm login
3. Publish:

npm publish

After publishing, users can install it with:

npm install -g streak-tracker-cli