GoGauge
August 13, 2026 Β· View on GitHub
A local-first usage dashboard for OpenCode Go: quota windows, token breakdown, model ranking and usage records β all in one place.
πΈ Screenshots
| Home (Light) | Home (Dark) |
|---|---|
 |  |
| Stats | Records |
|---|---|
 |  |
| Settings | Login | About |
|---|---|---|
 |  |  |
β¨ Features
- Quota monitoring: 5h rolling / weekly / monthly windows with progress bars, remaining % and reset countdown
- Usage overview: cache hit rate / hit amount / total tokens (incl. cache hits) / requests / cost / sessions
- Today's trend: 24-hour input / output bar chart
- Usage stats: token breakdown (input / output / reasoning / cache read / cache write / sessions), model usage donut + ranking, cost / requests / total tokens triple-line trend
- Session history: per-session aggregation of requests / input / output / reasoning / total tokens / cost, paginated
- Usage records: request-level detail with pagination and model filtering
- Built-in WebView login: independent login window opens the official auth page, auto-fills cookie & workspace β no manual copy-paste
- Auto sync: incremental sync (1/5/15/30 min) + sync range (30/60/90/180 days / All)
- Dual themes: light / dark toggle; bilingual UI (δΈζ / English)
- System tray: closing the window minimizes to tray; brand logo icons
- Local-first: all data stays in local SQLite; credentials are only used to sync official APIs
π₯ Quick Start
Binary (Windows)
Download GoGauge.exe from Releases (single file, no install):
- Double-click to run, click "Login Now" on the welcome page β an official auth window pops up
- After login, the dashboard loads and usage data syncs automatically
- Data is stored in the
data\folder next to the exe
Requires Windows 10/11 (WebView2 Runtime built-in). Closing the window minimizes to the system tray.
From Source
pip install -r requirements.txt
python entry.py
Build
build.bat
Output: dist\GoGauge.exe (~38 MB, --noconsole, logo icon and tray support included).
π Data Notes
- Source: opencode.ai workspace usage API (
/_serverserver-fn) + quota page HTML parsing - Total tokens = input (incl. cache hits) + output + reasoning
- Cache hit rate = hits / (hits + misses)
- Cost: raw USD; CNY converted via open.er-api.com live FX rate (24h cache)
π Privacy
- Login cookie stays on your machine only β never logged, never uploaded
- Usage data is stored entirely locally; the app contains no telemetry
π Tech Stack
Python Β· pywebview (WebView2) Β· SQLite Β· Chart.js Β· pystray
π¬ Contact
- GitHub: yphyphyph/opencode-go-gauge
- CSDN: Ying_ph
π License
MIT Β© GoGauge