tiennm99/claude-code-usage-bubble

0 Fork 0

mirror of https://github.com/tiennm99/claude-code-usage-bubble.git synced 2026-10-13 06:15:18 +00:00

Files

T

tiennm99 2c67dd1217 feat(providers): prepare provider terminology and metadata

2026-06-02 15:09:50 +07:00

3.9 KiB

Raw Permalink Blame History

title, description, status, priority, branch, tags, blockedBy, blocks, created, createdBy, source

title

description

status

priority

branch

OpenCode Go Provider Support And Providers Terminology

Overview

Add OpenCode Go as a third selectable usage provider beside Claude Code and Codex. Rename the app's user-facing "Models" menu/copy to "Providers" because the app chooses quota sources/services, not individual model IDs.

I agree with the rename. OpenCode itself still has a /models command, but this app's menu toggles Claude Code, Codex, and OpenCode Go providers. Internals already use ProviderId, so the naming is conceptually aligned.

Codebase Findings

Rust Win32 app; usage abstraction lives under src/usage/*.
Current extension points: UsageProvider, ProviderId, Registry, CredentialSource, RefreshHint.
Two-provider assumptions remain in src/settings.rs, src/app.rs, src/tray/mod.rs, src/tray/badge.rs, src/panel.rs, src/usage_color.rs, i18n TOMLs, and README.
OpenCode official docs say Go is configured as an OpenCode provider, uses /connect, stores credentials in ~/.local/share/opencode/auth.json, has 5h/weekly/monthly dollar-value limits, and current usage is visible in the console.
User decision: OpenCode Go should display four bars in two parts: upper part is weekly usage, lower part is monthly usage. Each part has the same two concepts as current Claude/Codex: usage percent and remaining time. Keep Claude/Codex on their existing two-bar presentation unless a separate UI redesign decides otherwise.
OpenCode docs expose model endpoints and https://opencode.ai/zen/go/v1/models, but do not document a stable usage endpoint. Do not fake usage percentages.
Phase 1 found the OpenCode console computes weeklyUsage and monthlyUsage with usagePercent and resetInSec, but only through an authenticated console server query. opencode stats is local cost/token history and cannot drive the requested Go bars.

plans/260516-0707-cleanroom-rewrite/plan.md: introduced current provider abstraction; related, no blocking dependency.
plans/260523-ui-ux-improvement-plan/plan.md: overlaps labels/tooltips; related, no blocking dependency.

Phases

Phase	Name	Status
1	Research OpenCode Go contracts	Blocked
2	Refactor provider metadata and settings	Completed
3	Implement OpenCode Go provider	Pending
4	Rename Models UI to Providers	In Progress
5	Verify and document	Pending

Dependencies

Phase 1 gates Phase 3. If no stable OpenCode Go usage source is found, pause before Phase 3 and ask user whether to defer usage support or ship a limited connectivity/auth detector.

Phase 2 is implemented. Phase 4 provider wording is implemented; OpenCode Go remains listed but disabled until Phase 1's quota-source decision is resolved.

Success Criteria

OpenCode Go can be enabled/disabled independently without breaking Claude Code or Codex.
Existing settings migrate safely; at least one provider remains enabled.
UI and README say "Providers" where the app means selectable services.
No guessed OpenCode Go usage. Weekly/monthly percent and reset-time data comes from verified source, or feature pauses.
cargo test and cargo build --release pass.

Sources

OpenCode Go docs: https://dev.opencode.ai/docs/go/
OpenCode CLI docs: https://opencode.ai/docs/cli/
Current repo README: README.md

3.9 KiB Raw Permalink Blame History