TokenDash v1.6.1

Changes

• Reuse a compatible same-version CLI/npm service from the macOS menu bar app so the dashboard stays aligned across install paths.
• Keep the menu bar update checker working after GitHub REST API rate limits by falling back to the public latest-release redirect.
• Make Electron coordination tests read the current package version instead of hard-coding the previous release.

Verification

• npm test: 115 passed
• npm run typecheck: passed
• npm run build:all: passed
• npm run test:e2e: 36 passed
• npm pack --dry-run: passed

Assets

• TokenDash-1.6.1-arm64.dmg
• TokenDash-1.6.1-arm64.dmg.blockmap

SHA256 dmg: a226126f8dce88d469813e4fc698f8e3bc1799a8e57c4fde61292ef415d47f04

TokenDash v1.6.0

TokenDash v1.6.0

What's Changed

• Refreshed the menu bar popover with a more native macOS developer-dashboard layout.
• Polished the hourly usage chart with aligned dashed grid lines, peak labels, and value-only hour labels to reduce clutter.
• Simplified hourly labels to hour-only ticks.
• Fixed the Settings drawer overlay so chart layers do not bleed through.
• Added compact Projects and Agents usage tables for quick daily breakdowns.
• Tightened the fixed-height tray layout so bottom actions remain visible after data loads.

Validation

• npm test passed: 12 files / 107 tests.
• npm run build:all completed and generated the macOS arm64 DMG.
• Local DMG was installed and localhost:3456/popover.html was verified to contain the overlay and hour-label fixes.

Includes

• Remote main changes through #16, including token accounting alignment and cache hit rate fixes.

v1.5.0

What's Changed

Fixes

• Project name display — correctly display project names with dashes (e.g. ccusage-dashboard instead of dashboard) using filesystem-based path decoding (#14)
• Tool call trend chart — fill missing tool values with 0 so chart lines don't break when a tool has no data for a given day (#13)

Installation

npm install -g @zhangferry-dev/tokendash@1.5.0

Full Changelog: v1.4.2...v1.5.0

v1.4.2

Changes

• Avoid double-counting duplicate Codex usage snapshots when parsing session data.
• Add regression coverage for duplicate Codex snapshot handling.
• Keep the native tray helper compatible with macOS 14.

Verification

• npx vitest run --testTimeout 30000
• npm run build:all
• npm publish @zhangferry-dev/tokendash@1.4.2

v1.4.1

What's Changed

Chart Improvements

• Y-axis nice numbers — axis ticks now use clean integer steps (e.g. 500, 1000, 1500 instead of arbitrary values)
• Bar-tip cleanup — removed border and background from peak value label for a cleaner look
• Y-axis alignment — fixed label alignment with grid lines

macOS Tray

• Template image rendering — tray text now rendered as a native template image for cleaner status bar appearance

Bug Fixes

• Popover infinite loading — fixed JS syntax error that prevented the popover dashboard from loading

Docs

• Moved changelog to separate CHANGELOG.md
• Added macOS menu bar screenshot to README
• Updated macOS capabilities section

Full Changelog: v1.4.0...v1.4.1

v1.4.0

What's New in v1.4.0

macOS Menu Bar App 🖥️

• Native Tray Icon — real-time token count and cost in the macOS 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 with custom 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, quit

Other Improvements

• Custom app icon and menu bar icon
• GitHub Releases-based update checker
• Tray badge syncs with popover agent filter

Installation

Download TokenDash-1.4.0-arm64.dmg, open it, and drag TokenDash to your Applications folder.

Full Changelog: v1.3.0...v1.4.0