TokenWatch 0.1.0 — UI redesign, rename, mini HUD, i18n

A ground-up rebrand on top of the Windows port work:

UI
- Full Claude/Anthropic warm-parchment design system (serif headlines,
  terracotta accents, ring shadows, no cool greys)
- Replaced all rainbow-gradient icon pills with lucide line icons on warm
  sand discs
- Dashboard: serif metric numbers, dual circular rings (token usage +
  5-hour session reset countdown), centered
- Analytics: terracotta mono-tone charts, warm model distribution donut,
  editorial segmented controls, metric cards with badges
- Terminal: Claude dark-section treatment (near-black + warm silver),
  monospace key-value rows with dot leaders
- Settings: serif titles, lucide section icons, restyled Switch with
  clear terracotta/sand contrast
- Frameless window with custom title bar; header is the drag region,
  interactive controls opt out; fixed header (never scrolls)
- Mini HUD: optional always-on-top 220x64 widget with 3 content modes
  (percent / percent+cost / percent+cost+burn rate); persists position

i18n
- react-i18next; English + 简体中文; auto-detect + manual override in
  Settings; applies before first paint

Rename (CCSeva -> TokenWatch)
- package.json, electron-builder, AppUserModelID, tray tooltip, window
  title, screenshots path, login item, HTML title, i18n strings, README,
  CLAUDE.md, LICENSE (original copyright preserved per MIT)
- Settings / caches moved from ~/.ccseva to ~/.tokenwatch (pricing patch
  updated to match)

Fixes
- Timezone bug: daily grouping now uses local date (not UTC) so "today"
  matches the user's clock
- Per-entry grouping (not block.startTime) so sessions spanning midnight
  split cleanly into correct days
- Tooltip i18n for the dashboard ring status
- Redundant /Windows/native title bar removed; custom min/max/close
  buttons with close-hover terracotta

Author: sooua

CLAUDE.md

@@ -4,7 +4,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-CCSeva is a macOS menu bar Electron application that monitors Claude Code usage in real-time. The app uses the `ccusage` npm package API to fetch token usage data and displays it through a modern React-based UI with tabbed navigation, analytics, notifications, and visualizations.
+TokenWatch is a cross-platform (Windows + macOS) tray/menu-bar Electron application that monitors Claude Code usage in real-time. The app uses the `ccusage` npm package API to fetch token usage data and displays it through a warm Claude-inspired React UI with tabbed navigation, analytics, notifications, and visualizations.
+
+TokenWatch started as a Windows port of [CCSeva](https://github.com/Iamshankhadeep/ccseva) (MIT), with a full UI redesign, frameless custom title bar, i18n, worker-thread parsing, and local ccusage performance patches.
 
 ## Essential Commands
 
@@ -52,7 +54,7 @@ The app follows standard Electron patterns with clear separation:
 
 #### Service Layer (Singleton Pattern)
 - **CCUsageService**: Uses the `ccusage` npm package data-loader API to fetch usage data, implementing a 30-second cache. Now supports plan configuration and actual session-based reset times.
-- **SettingsService**: Manages user preferences persistence to `~/.ccseva/settings.json` including plan selection, custom token limits, timezone, and reset hour settings
+- **SettingsService**: Manages user preferences persistence to `~/.tokenwatch/settings.json` including plan selection, custom token limits, timezone, and reset hour settings
 - **NotificationService**: Manages macOS notifications with cooldown periods and threshold detection
 - **ResetTimeService**: Handles Claude usage reset time calculations and timezone management
 - **SessionTracker**: Tracks user sessions and activity patterns for analytics
@@ -178,7 +180,7 @@ When using the `ccusage` package data-loader API:
 
 ### Settings Management & Plan Selection (Latest)
 - **Claude Plan Settings**: Added comprehensive plan selection in SettingsPanel with Auto-detect, Pro, Max5, Max20, and Custom options
-- **Persistent Settings**: Extended SettingsService to save plan preferences to `~/.ccseva/settings.json` with backward compatibility
+- **Persistent Settings**: Extended SettingsService to save plan preferences to `~/.tokenwatch/settings.json` with backward compatibility
 - **Custom Token Limits**: Custom plan option allows users to set non-standard token limits with validation
 - **Real-time Plan Display**: TerminalView now shows selected plan settings instead of just auto-detected plans
 - **Settings UI Enhancement**: Professional plan selection dropdown with token limit display and current plan detection
@@ -202,7 +204,7 @@ When using the `ccusage` package data-loader API:
 
 ### Current Project Structure
 ```
-ccseva/
+tokenwatch/
 ├── main.ts                     # Electron main process with tray management
 ├── preload.ts                  # Secure IPC bridge
 ├── src/
@@ -262,7 +264,7 @@ Since there are no automated tests, manual verification checklist:
 8. **Data consistency**: Ensure displayed data matches `ccusage` output
 9. **Actual reset time accuracy**: Verify session-based reset times from active blocks
 10. **Session tracking**: Confirm session data persistence and analytics
-11. **Settings persistence**: Confirm plan and preference settings save to `~/.ccseva/settings.json`
+11. **Settings persistence**: Confirm plan and preference settings save to `~/.tokenwatch/settings.json`
 
 ### Plan Management & Settings
 12. **Plan selection**: Test Auto-detect, Pro, Max5, Max20, and Custom plan options in SettingsPanel

LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
-Copyright (c) 2024 Claude Monitor
+Copyright (c) 2024 Claude Monitor (original CCSeva project)
+Copyright (c) 2026 TokenWatch contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +19,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -1,69 +1,51 @@
-# CCSeva 🤖
+# TokenWatch
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![GitHub release](https://img.shields.io/github/release/Iamshankhadeep/ccseva.svg)](https://github.com/Iamshankhadeep/ccseva/releases)
-[![Build Status](https://img.shields.io/github/actions/workflow/status/Iamshankhadeep/ccseva/ci.yml?branch=main)](https://github.com/Iamshankhadeep/ccseva/actions)
-[![Downloads](https://img.shields.io/github/downloads/Iamshankhadeep/ccseva/total.svg)](https://github.com/Iamshankhadeep/ccseva/releases)
-[![macOS](https://img.shields.io/badge/macOS-10.15%2B-blue)](https://github.com/Iamshankhadeep/ccseva)
-[![Windows](https://img.shields.io/badge/Windows-10%2F11-0078D4)](https://github.com/Iamshankhadeep/ccseva)
+[![Windows](https://img.shields.io/badge/Windows-10%2F11-0078D4)](#installation)
+[![macOS](https://img.shields.io/badge/macOS-10.15%2B-blue)](#installation)
 
-A beautiful menu bar / tray app for tracking your Claude Code usage in real-time. Monitor token consumption, costs, and usage patterns with an elegant interface.
-
-## Screenshots
-
-![Dashboard](./screenshots/dashboard.png)
-![Analytics](./screenshots/analytics.png)
-![Terminal](./screenshots/terminal.png)
+A warm, editorial tray app that keeps a quiet eye on your Claude Code token usage. Lives in the system tray on Windows / menu bar on macOS, shows real-time consumption, cost, and burn rate, and stays out of the way the rest of the time.
 
 ## Features
 
-- **Real-time monitoring** - Live token usage tracking with 30-second updates
-- **Menu bar / tray integration** - Percentage indicator with color-coded status (macOS); hover tooltip + dynamic context menu (Windows)
-- **Smart plan detection** - Auto-detects Pro/Max5/Max20/Custom plans
-- **Usage analytics** - 7-day charts, model breakdowns, and trend analysis
-- **Smart notifications** - Alerts at 70% and 90% thresholds with cooldown
-- **Cost tracking** - Daily cost estimates and burn rate calculations
-- **Instant cold start** - Persists the last snapshot to disk so subsequent launches render the full UI immediately, then refresh in the background
-- **Single-instance lock** - Relaunching the app surfaces the existing window instead of opening a second tray icon
-- **Launch on startup** *(optional)* - Start CCSeva minimized to the tray when you sign in (Settings → Launch on Startup)
-- **Standalone window mode** *(optional)* - Switch the tray popup to a normal resizable window with a taskbar entry (Settings → Standalone Window)
-- **Worker-thread parsing** - ccusage JSONL parsing runs in a `worker_threads` worker so the tray and UI stay responsive while large histories load
-- **Beautiful UI** - Gradient design with glass morphism effects
+- **Live tray display** — hovering the tray icon shows the current usage percentage and cost; click to open the full view
+- **Parchment UI** — warm Claude-inspired design system (serif headings, terracotta accents, ring shadows) instead of the usual cool-grey dashboard look
+- **Standalone window mode** — optional normal resizable window with a taskbar entry, in addition to the default tray-anchored popup
+- **Instant cold start** — persists the last snapshot to disk so subsequent launches render the full UI immediately, then refresh in the background
+- **Worker-thread parsing** — ccusage JSONL parsing runs in a `worker_threads` worker so the tray and UI stay responsive while large histories load
+- **Smart plan detection** — auto-detects Pro / Max5 / Max20 / Custom from actual usage, or pick one manually
+- **Analytics** — 7-day and 30-day trends as area / line / bar, model distribution donut, per-hour burn rate, plan utilization, depletion prediction
+- **Terminal view** — a calm monospace readout for when you just want the numbers
+- **Smart notifications** — alerts at 70% and 90% thresholds with cooldown
+- **Single-instance lock** — relaunching surfaces the existing window instead of spawning a duplicate tray icon
+- **Launch on startup** *(optional)* — starts minimized to the tray when you sign in
+- **i18n** — English and 简体中文, auto-detected from the system
 
 ## Installation
 
-### macOS
+### Windows
 
-Download the latest release from [GitHub Releases](https://github.com/Iamshankhadeep/ccseva/releases):
-- **Apple Silicon**: `CCSeva-darwin-arm64.dmg`
-- **Intel**: `CCSeva-darwin-x64.dmg`
+Download the latest release from GitHub Releases:
+- **Installer**: `TokenWatch-Setup-<version>-x64.exe` (NSIS, custom install directory, desktop & start-menu shortcuts)
+- **Portable**: `TokenWatch-Portable-<version>-x64.exe` (no installation required)
 
-### Windows
+Windows 10 / 11 (x64).
 
-Download the latest release from [GitHub Releases](https://github.com/Iamshankhadeep/ccseva/releases):
-- **Installer**: `CCSeva-Setup-<version>-x64.exe` (NSIS, supports custom install directory)
-- **Portable**: `CCSeva-Portable-<version>-x64.exe` (no installation required)
+### macOS
 
-Windows 10 / 11 (x64) are supported.
+- **Apple Silicon**: `TokenWatch-darwin-arm64.dmg`
+- **Intel**: `TokenWatch-darwin-x64.dmg`
 
-### Build from Source
+### Build from source
 
 ```bash
-git clone https://github.com/Iamshankhadeep/ccseva.git
-cd ccseva
-npm install   # applies patches/ccusage+*.patch via postinstall
+git clone <this-repo>
+cd tokenwatch
+npm install   # also applies patches/ccusage+*.patch via postinstall
 npm run build
 npm start
 ```
 
-> **Note**: `npm install` runs `patch-package` on `postinstall` to apply a small local patch to ccusage (`patches/ccusage+18.0.8.patch`). The patch does three things:
->
-> 1. **Skip the pre-read file sort** — `loadSessionBlockData` was opening and streaming every JSONL file just to find its earliest timestamp, then opening each file again to read entries. `identifySessionBlocks` already sorts entries by timestamp internally, so the pre-sort is redundant. Cuts cold-start I/O in half.
-> 2. **Parallelize file processing** — the upstream serial `for (const file of sortedFiles) await processJSONLFileByLine(file, ...)` is replaced with a bounded `Promise.all` (cap: 32 concurrent files) to keep libuv's I/O thread pool busy.
-> 3. **Persist LiteLLM pricing to disk** — the upstream fetcher re-downloads pricing from GitHub on every run. We cache the response at `~/.ccseva/pricing-cache.json` with a 24h TTL and skip the network round-trip when the cache is fresh. Cost calculation accuracy is unchanged.
->
-> Typical impact on a 1,700-file history: cold start ~49s → ~12–30s depending on disk cache state. Subsequent runs also avoid the 1–5s LiteLLM fetch.
-
 Packaging:
 
 ```bash
@@ -72,6 +54,14 @@ npm run dist:win   # Windows NSIS installer + portable exe
 npm run dist       # Current platform (auto)
 ```
 
+> **Note**: `npm install` runs `patch-package` on `postinstall` to apply a small local patch to ccusage (`patches/ccusage+18.0.8.patch`). The patch:
+>
+> 1. **Skips the pre-read file sort** — `loadSessionBlockData` opens and streams every JSONL file just to find its earliest timestamp, then opens each file again to read entries. `identifySessionBlocks` already sorts entries by timestamp internally, so the pre-sort is redundant. Cuts cold-start I/O in half.
+> 2. **Parallelizes file processing** — the upstream serial `for (const file of sortedFiles) await processJSONLFileByLine(file, ...)` is replaced with a bounded `Promise.all` (cap: 32 concurrent files) to keep libuv's I/O thread pool busy.
+> 3. **Persists LiteLLM pricing to disk** — the upstream fetcher re-downloads pricing from GitHub on every run. We cache the response at `~/.tokenwatch/pricing-cache.json` with a 24h TTL and skip the network round-trip when the cache is fresh. Cost calculation accuracy is unchanged.
+>
+> Typical impact on a 1,700-file history: cold start ~49s → ~12–30s depending on disk cache state. Subsequent runs also avoid the 1–5s LiteLLM fetch.
+
 #### Windows packaging prerequisites
 
 `electron-builder` creates symbolic links while extracting the `winCodeSign` helper on Windows. If the build fails with `Cannot create symbolic link : 客户端没有所需的特权` (or similar), enable one of the following:
@@ -87,28 +77,24 @@ Remove-Item -Recurse -Force "$env:LOCALAPPDATA\electron-builder\Cache\winCodeSig
 
 We don't ship signed Windows binaries; unless you set your own certificate, builds skip code signing automatically (`CSC_IDENTITY_AUTO_DISCOVERY=false` is safe to set if you see signing prompts).
 
-### Development
-
-```bash
-npm run electron-dev  # Watch build + launch Electron with reload
-```
-
 ## Usage
 
-1. **Launch** - CCSeva appears in your menu bar (macOS) or notification area / system tray (Windows).
-2. **Left-click the tray icon** - Toggle the main window.
-3. **Right-click the tray icon** - Context menu: current usage %, cost, Open, Refresh, Quit.
+1. **Launch** — TokenWatch appears in your menu bar (macOS) or notification area / system tray (Windows)
+2. **Left-click the tray icon** — toggle the main window
+3. **Right-click the tray icon** — context menu: current usage %, cost, Open, Refresh, Quit
+4. **Drag the window** — the header is the drag handle (frameless window with custom Claude-styled controls)
 
-The app automatically detects your Claude Code configuration from the `~/.claude` directory (Windows: `%USERPROFILE%\.claude`) and refreshes every 30 seconds.
+The app reads your Claude Code usage history from `~/.claude/projects/**/*.jsonl` and refreshes every 30 seconds.
 
 ### Platform differences
 
 | Behavior | macOS | Windows |
 |---|---|---|
 | Tray label (% / $) | Rendered as text directly in the menu bar via `Tray.setTitle` | Shown in the tooltip on hover and in the right-click context menu header (Windows tray icons cannot display text) |
 | Tray icon | Empty (text-only) | PNG / ICO icon (`assets/tray.ico`) |
+| Window chrome | Custom title bar (no native) | Custom title bar with minimize / maximize / close buttons |
 | Window anchor | Top-right, near the menu bar | Near the tray icon, clamped to the active display |
-| Notifications | Native Notification Center | Toast center (requires `AppUserModelId`, set automatically by the app) |
+| Notifications | Native Notification Center | Toast center (requires `AppUserModelId`, set automatically) |
 
 ## Requirements
 
@@ -119,17 +105,27 @@ The app automatically detects your Claude Code configuration from the `~/.claude
 ## Tech Stack
 
 - Electron 36 + React 19 + TypeScript 5
-- Tailwind CSS 3 + Radix UI components
-- ccusage package for data integration
+- Tailwind CSS 3 with a custom Claude-inspired warm palette
+- Radix UI primitives
+- i18next + react-i18next
+- ccusage for usage data (with local performance patches via patch-package)
+
+## Data stored locally
+
+TokenWatch keeps small files under `~/.tokenwatch/`:
+
+- `settings.json` — user preferences (language, plan, display mode, etc.)
+- `stats-cache.json` — last-known usage snapshot, used to render the UI instantly on cold start
+- `pricing-cache.json` — LiteLLM model pricing table, 24h TTL
+
+Nothing is sent anywhere else — the only network call is ccusage's pricing fetch from GitHub (cached).
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License — see [LICENSE](LICENSE).
 
 ## Credits
 
-Built with ❤️ using [Electron](https://electronjs.org), [React](https://reactjs.org), [Tailwind CSS](https://tailwindcss.com), and [ccusage](https://github.com/ryoppippi/ccusage).
-
----
+TokenWatch is based on [CCSeva](https://github.com/Iamshankhadeep/ccseva) by **Iamshankhadeep** (MIT). The Windows port, warm-parchment UI redesign, worker-thread parsing, ccusage performance patches, frameless custom title bar, and i18n support were added on top of that foundation.
 
-**Note**: This is an unofficial tool for tracking Claude Code usage. Requires a valid Claude Code installation and configuration.
+Built with [Electron](https://electronjs.org), [React](https://reactjs.org), [Tailwind CSS](https://tailwindcss.com), [Radix UI](https://www.radix-ui.com), [lucide-react](https://lucide.dev), and [ccusage](https://github.com/ryoppippi/ccusage).

electron-builder.json

@@ -1,6 +1,6 @@
 {
-  "appId": "com.ccseva.app",
-  "productName": "CCSeva",
+  "appId": "com.tokenwatch.app",
+  "productName": "TokenWatch",
   "directories": {
     "output": "release"
   },
@@ -22,16 +22,16 @@
     "gatekeeperAssess": false,
     "extendInfo": {
       "LSUIElement": true,
-      "CFBundleDisplayName": "CCSeva",
-      "CFBundleName": "CCSeva",
-      "CFBundleExecutable": "CCSeva",
-      "NSHumanReadableCopyright": "Copyright © 2024 CCSeva. All rights reserved.",
+      "CFBundleDisplayName": "TokenWatch",
+      "CFBundleName": "TokenWatch",
+      "CFBundleExecutable": "TokenWatch",
+      "NSHumanReadableCopyright": "Copyright © 2026 TokenWatch contributors. All rights reserved.",
       "CFBundleDocumentTypes": [],
       "LSMinimumSystemVersion": "10.15.0"
     }
   },
   "dmg": {
-    "title": "CCSeva",
+    "title": "TokenWatch",
     "icon": "assets/icon.icns"
   },
   "win": {
@@ -54,10 +54,10 @@
     "allowToChangeInstallationDirectory": true,
     "createDesktopShortcut": true,
     "createStartMenuShortcut": true,
-    "shortcutName": "CCSeva",
+    "shortcutName": "TokenWatch",
     "installerIcon": "assets/icon.ico",
     "uninstallerIcon": "assets/icon.ico",
-    "uninstallDisplayName": "CCSeva"
+    "uninstallDisplayName": "TokenWatch"
   },
   "portable": {
     "artifactName": "${productName}-Portable-${version}-${arch}.${ext}"