open-streak

GitHub-style terminal activity heatmap for your OpenCode usage data.

Disclaimer: This is an independent, open-source project built by the community. It is not built by, endorsed by, or affiliated with the OpenCode team in any way.

╭────────────────────────────────────────────────────────────────────────╮
│ OpenCode  414M tokens  ·  52w                                        │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│ JunJul Aug  Sep Oct Nov  Dec Jan Feb Mar  Apr May  J                   │
│ ····················································                   │
│ Mon ····················································               │
│ ····················································                   │
│ Wed ···················································░               │
│ ···········································░·······█                   │
│ Fri ···················································◈               │
│ ···················································                    │
│ Less · ░ ▒ ▓ █ More                                                    │
│                                                                        │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│ 4  active   │   3  streak   │   3  best   │   414M  all-time           │
│                                                                        │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│ ⬡ v0.1.0   │   ● 3d streak   │   $7.90 total cost                      │
│                                                                        │
╰────────────────────────────────────────────────────────────────────────╯

Requirements

• Node.js >= 22.5.0 (for built-in node:sqlite support)

Quick start

No install needed:

npx open-streak

Or install globally:

npm install -g open-streak
# or
pnpm add -g open-streak

Usage

Dashboard

npx open-streak                    # Full heatmap dashboard
npx open-streak --weeks 26         # Show 26 weeks
npx open-streak --weeks 4          # Show 4 weeks
npx open-streak --no-color         # Disable colors
npx open-streak --json             # Output as JSON
npx open-streak --json --weeks 8   # JSON for 8 weeks

Subcommands

npx open-streak models                  # Token usage by model
npx open-streak models claude           # Filter models by name
npx open-streak models --json           # JSON output

npx open-streak projects                # Activity by project
npx open-streak projects whatsapp       # Filter projects by name
npx open-streak projects --json         # JSON output

npx open-streak trends                  # Weekly sparkline chart
npx open-streak trends --json           # JSON output

Filtering

npx open-streak --project myapp         # Filter heatmap by project
npx open-streak --db /path/to/db        # Custom database path
npx open-streak --version               # Show version

Options

Flag	Description
--db <path>	SQLite database path (default: ~/.local/share/opencode/opencode.db)
--weeks <4-104>	Heatmap width in weeks (default: 52)
--project <name>	Filter heatmap activity by project directory name
--json	Output as JSON
--no-color	Disable ANSI colors
-v, --version	Show version

Subcommands

Command	Description
models [filter]	Token usage by model (claude-sonnet-4, claude-opus-4, etc.)
projects [filter]	Activity by project directory
trends [filter]	Weekly trend sparkline chart

The optional [filter] narrows results to matching names.

Features

• 5-level heatmap with GitHub-style color ramp
• Today indicator — highlighted cell on the current day
• Streak tracking — current and longest consecutive active days
• Model breakdown — see which models use the most tokens
• Project activity — token usage per project
• Cost tracking — API costs color-coded by threshold
• Adaptive colors — detects dark/light terminal, WCAG AAA contrast
• Gradient bars with sub-character precision (▏▎▍▌▋▊▉█)
• Box-drawing UI with consistent 74-char alignment
• Zero native dependencies — uses Node.js built-in node:sqlite
• JSON output for scripting and automation

Metrics

Display	Source
Daily square	Assistant-message token totals for one calendar day
Color intensity	Relative token usage across days with activity
Today indicator	Highlighted ◈ cell for current day
Current streak	Consecutive days with activity ending today
Longest streak	Longest consecutive run of active days
Model breakdown	Token usage per model
Cost	API cost per day/model

Development

pnpm install
pnpm build
pnpm test
pnpm dev

Support

If this tool saved you time, consider buying me a coffee ☕

Made by

Jad Madi — jadmadi.net · @jadmadi · github.com/jadmadi

License

MIT — see LICENSE for details.