About this project

The OpenCode Go Plan Widget is a native macOS WidgetKit widget and fixed-size dashboard application designed to display OpenCode Go plan quota usage and costs on the desktop in real time. The app offers a DMG installer and a ZIP portable version, supports Apple Silicon and Intel, requires macOS 14.0+, and stores data locally only. After installation, drag the OpenCode Widget.app into the Applications folder, then configure it via the settings in the upper-right corner after launching. It is recommended to use browser login for automatic setup: log in to opencode.ai in the pop-up window, and the app will automatically save the workspace and Cookie, retrieve the full Go Key from the official key page into the Keychain, and complete the replacement. Optionally configure a DeepSeek Key. Manual configuration also supports pasting an API Key starting with sk-, pasting a workspace usage link, or importing a HAR file for automatic extraction. The API Key is stored in the macOS Keychain, and workspace credentials are stored locally in the App Group, never uploaded to third parties. The desktop widget displays three quota tiers (5 hours, weekly, monthly) with progress bars and countdowns to reset, along with daily stacked costs for the last 7 days. Clicking the chart opens the main app, and clicking the refresh button updates immediately. The main dashboard is a fixed 620×860 window showing a full-month daily stacked bar chart by model, with empty days not collapsed, a unified color scheme for model legends, and a separate display of today's model proportions. The Go quota chart syncs in real time with the official opencode.ai Go quota document, displaying request counts for 5h, weekly, and monthly periods in the same row with specific values, using relative scales of 1x/10x/25x/50x/100x/250x to compare model quota magnitudes, with free trial models individually marked. For settings and security, key management is provided: you can display plaintext, replace, or individually clear the quota Key, workspace credentials, Codex Go/DeepSeek Key, with confirmation before clearing. The embedded browser login automatically retrieves the Go Key, workspace, and Cookie; login credentials are stored only locally and can be cleared with one click. HAR import can automatically parse the raw workspace ID and authentication Cookie. Support for toggling launch on startup is available, and it can also be managed in system login items. The app works in conjunction with the native WidgetKit widget and the main app: clicking the widget chart opens the main dashboard, supports launch on startup, and stays on the desktop for viewing quotas and costs.