token-contribution
GitHub-style daily token usage contribution calendar, model analytics, and timeline trends for DeepSeek Harness.
Installation
Install with a single command via the official DSH CLI:
dsh plugin --profile web add token-contribution
(To remove later: dsh plugin --profile web remove token-contribution)
Manual Alternative (pnpm)
cd ~/.dsh/profiles/web
pnpm add token-contribution
Then add "token-contribution" to bundles in ~/.dsh/profiles/web/package.json.
Preview
Token Heatmap Overview
Model Usage Breakdown & Trends
Features
- 52-Week GitHub Contribution Calendar: 7 rows × 52 columns tracking daily token activity with a smooth monochromatic gradient anchored on DeepSeek's official brand blue (
#3964FE).
- Interactive Day Inspector: Click on any day to slide open an inspection drawer showing every session active on that date, exact timestamps, and token breakdown.
- Top Model Usage Breakdown: Real-time distribution showing tokens, percentages, and request steps for every model used across sessions.
- Token Usage Trends Timeline: Stacked bar chart comparing daily Billed Tokens vs. Cache Reads, with 14D / 30D / 90D range filters and hover tooltips.
- Global & Per-Session Filtering: Toggle between aggregate global history or inspect token activity for individual sessions.
- Auto-Expanding Panel: Smoothly widens the DSH Settings dialog to 1180px so the calendar and charts fit cleanly with zero scrollbars.
- Session Token Meter Integration: Injects a clean action button into the in-session token usage dialog to open the heatmap directly from active sessions.
- High-Performance Parser: Recursively aggregates local
.jsonl.zstd logs with timestamp and mtime caching for instant loading.
Usage
- Open the DeepSeek Harness Web GUI (
http://127.0.0.1:3080).
- Go to Settings (gear icon at the bottom left) → Token Heatmap.
- Or during any session, click on the token stats pill at the bottom of the composer and tap "View Token Usage Heatmap →".
License
MIT © oiupoyt
