Repository navigation
π OpenCode Go Tracker v1.0.0 β Initial Multiplatform Release
I'm excited to announce the first official multiplatform release of OpenCode Go Tracker! π
Ported from the original native macOS app (Swift/AppKit) to Electron + React + TypeScript, this version brings full feature parity, clean architecture, and native support across macOS,
Windows, and Linux.
β¨ Features & Highlights
- Tray-Only Presence: Runs exclusively in the macOS Menu Bar, Windows System Tray, and Linux StatusNotifierItem. No clutter in your Dock or Taskbar.
- Three Real-Time Quota Windows:
- β±οΈ 5-Hour Rolling Window: Instant percentage and reset countdown displayed directly in the tray title and popup panel (
>_ 42%). - π Weekly Quota: Track accumulated weekly usage.
- π Monthly Quota: Monitor your full billing cycle limits.
- β±οΈ 5-Hour Rolling Window: Instant percentage and reset countdown displayed directly in the tray title and popup panel (
- Semantic Color Thresholds:
- π’ Normal (
< 50%): Green (#30D158) - π‘ Warning (
50% β 79%): Yellow (#FFD60A) - π΄ Critical (
β₯ 80%): Red (#FF453A)
- π’ Normal (
- Smart Countdown Timers: Locally updated every minute (
Resets in 3h 05min) without incurring extra API overhead. - Visual Resilience (Stale-While-Revalidate): Temporary network glitches or API latency preserve the last known good data on-screen instead of flashing disruptive error views.
- Automatic Localization (i18n): Native auto-detection of your system language (
pt-BRanden-US).
π Privacy & Security (Zero-Footprint Guarantee)
- Zero Disk Persistence: The application creates no local databases, preference files, or logs on disk.
- Ephemeral In-Memory Keys: Manually entered keys are held strictly in main process RAM and discarded immediately upon quit.
- Profile Isolation: Chromium's
userDatais dynamically redirected to the operating system's temporary directory ($TMPDIR) before boot. - Sandboxed Context Isolation: Strict
contextIsolation: true,sandbox: true, andnodeIntegration: falseensure credentials never leak into renderer heap memory.
π§ͺ Code Quality & Automated Coverage
- 92 automated unit and integration tests covering pure domain logic, IPC contracts, window lifecycle, and visual components.
- > 90% code coverage verified via Vitest v8:
- Lines:
90.83% - Statements:
90.83% - Functions:
92.30% - Branches:
86.64%
- Lines:
π¦ Installation
- macOS: Download the
.dmgmatching your architecture (arm64for Apple Silicon M1/M2/M3/M4 orx64for Intel) and drag it to yourApplicationsfolder. - Windows: Download the
.exe(NSIS installer) and follow the setup wizard. - Linux: Download the
.AppImage, make it executable (chmod +x OpenCodeGoTracker-*.AppImage), and run.
π Credentials Setup
The app automatically reads your credentials from ~/.local/share/opencode/auth.json. If you haven't connected your account in the terminal yet, run:
opencode providers login --provider opencode-goAlternatively, paste your API key directly into the application popup field (kept safely in memory only).