@zhangferry-dev/tokendash 1.3.0 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # tokendash
 
-A beautiful, local web dashboard for visualizing your Claude Code, Codex, and OpenClaw token usage statistics.
+A beautiful, local web dashboard for visualizing your Claude Code, Codex, OpenClaw, and OpenCode token usage statistics.
 
 It runs locally and parses token usage data directly from local session files, presenting it in a clean, interactive React dashboard. No external CLI dependencies required.
 
@@ -8,15 +8,17 @@ It runs locally and parses token usage data directly from local session files, p
 
 ## Features
 
-- **Multi-Agent Support:** View usage for Claude Code, Codex, and OpenClaw.
+- **Multi-Agent Support:** View usage for Claude Code, Codex, OpenClaw, and OpenCode.
 - **Direct JSONL Parsing:** Reads `~/.claude/projects/` JSONL files directly — no `ccusage` CLI dependency, 100x faster data loading.
 - **Detailed Metrics:** Track total tokens, cost (USD), active days, cache hit rates, and output/input ratio.
+- **Today by Hour:** 24-hour token consumption panel showing hourly breakdown for the current day.
 - **Code Analytics:** Visualize code change trends, tool call frequency, and productivity KPIs (Claude Code & OpenClaw only).
 - **Pricing Transparency:** Toggle Cost metric to see per-model pricing formula and rates.
 - **Interactive Charts:** Bar/line/area charts with tooltips, model breakdowns, and time range filtering.
 - **24-Hour Heatmap:** Activity distribution by hour and day of week, with timezone awareness.
 - **Model & Project Distribution:** See which models and projects drive your usage.
 - **Persistent Filters:** Your selected time range, project, and metric mode are saved automatically.
+- **macOS Menu Bar App:** Native tray icon with real-time token usage, popover dashboard, and agent filtering — runs silently in the background.
 - **Test Coverage:** Unit tests (Vitest) and E2E tests (Playwright) for reliability.
 
 ## Requirements
@@ -43,6 +45,16 @@ By default, the backend server runs on port `3456`. When running the production
 
 During development (`npm run dev`), Vite starts a separate development server on port `5173` with hot-module replacement. You should access the dashboard at `http://localhost:5173` while developing.
 
+### macOS Menu Bar App
+
+Download the latest `TokenDash.dmg` from [GitHub Releases](https://github.com/zhangferry/tokendash/releases). Open the DMG and drag TokenDash to your Applications folder.
+
+The menu bar app shows real-time token usage in the status bar. Click the icon to open a compact popover dashboard with:
+- Today's token count and cost breakdown
+- Hourly consumption chart
+- Agent filter (show only Claude Code, Codex, etc.)
+- Settings: launch at login, check for updates, quit
+
 ### Command Line Options
 
 ```bash
@@ -87,12 +99,28 @@ If you want to contribute or modify the dashboard locally:
 
 - **Frontend:** React 19, Recharts, Tailwind CSS (via Vite plugin), built with Vite.
 - **Backend:** Express, TypeScript.
-- **Data Source:** All agent data is parsed directly from local session files (`~/.claude/projects/`, `~/.codex/sessions/`). No external CLI dependencies.
+- **Data Source:** All agent data is parsed directly from local session files (`~/.claude/projects/`, `~/.codex/sessions/`) and OpenCode's SQLite database (`~/.local/share/opencode/opencode.db`). No external CLI dependencies.
 - **Caching:** Persistent disk cache (`/tmp/tokendash-cache/`) with stale-while-revalidate pattern for snappy UI updates.
 - **Testing:** Vitest (unit), Playwright (E2E). Run with `npm test` and `npm run test:e2e`.
+- **CI:** GitHub Actions pipeline for automated testing on every push and PR.
 
 ## Changelog
 
+### v1.4.0
+- **macOS Menu Bar App** — native tray icon with real-time token count and cost in the status bar
+- **Popover Dashboard** — click the tray icon for a compact dashboard with hourly chart, agent filter, and settings
+- **Native Swift Tray Helper** — lightweight binary for macOS 26+ compatibility, drawn SVG icon
+- **Agent Filter** — choose which agents to display in both popover and tray badge, persisted across sessions
+- **Settings Panel** — launch at login, check for updates (via GitHub Releases), quit
+- **Update Checker** — automatic version check against GitHub Releases
+
+### v1.3.0
+- **Added OpenCode agent support** — parses SQLite database at `~/.local/share/opencode/opencode.db`
+- **Added Today by Hour panel** — 24-hour token consumption breakdown for the current day
+- **E2E test overhaul** — comprehensive Playwright test suite with fixture-based test data
+- **Added CI pipeline** — GitHub Actions for automated testing on push and PR
+- **Fixed model trend chart** — included `cacheReadTokens` in model trend calculations
+
 ### v1.2.0
 - **Replaced `ccusage` CLI** with direct JSONL parser — data loads in 1-2ms instead of 12-30s
 - **Added code analytics** — code change trend, tool call trend, daily KPIs

package/bin/tokendash.js

@@ -1,2 +1,6 @@
 #!/usr/bin/env node
-import "../dist/server/index.js";
+import { main } from "../dist/server/index.js";
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});