Repolode
Submit
FluxCapacitor2

FluxCapacitor2/opencode-desktop-go-usage

An OpenCode Desktop plugin that shows your OpenCode Go monthly usage as a badge in the tab bar.

View on GitHub
Stars
0
Forks
0
Open issues
0
Last commit
11 days ago

What is it?

This plugin adds a small badge to the OpenCode Desktop tab bar that displays your current OpenCode Go monthly usage as a percentage inside a circular progress ring. Hovering over the badge opens a tooltip with monthly, weekly, and 5-hour usage, average usage per day, the projected usage at the end of the subscription term, and the date the monthly limit resets.

The badge refreshes every 10 minutes and works with both the horizontal and vertical tab layouts. It reads data through the desktop app's usage endpoint, `ctx.client.usage.limits()`, for the currently signed-in OpenCode Console workspace, so it does not handle user credentials itself.

Installation is a git clone into `~/.config/opencode/plugins/` followed by `bun install` and `bun run build`. The plugin is written in TypeScript and is MIT licensed.

Key features

  • 01Shows monthly usage as a percentage in a circular progress ring in the tab bar.
  • 02Hover tooltip with monthly, weekly, and 5-hour usage.
  • 03Shows daily usage and projected usage at the end of the subscription term.
  • 04Displays the monthly reset date.
  • 05Refreshes automatically every 10 minutes.
  • 06Supports horizontal and vertical tab layouts.

Use cases

  • Keeping an eye on OpenCode Go quota while coding in OpenCode Desktop.
  • Checking whether current usage is on track to last until the end of the billing month.
  • Seeing when the monthly limit resets without opening the web console.

Quick start

  1. 1

    Create the OpenCode plugins folder

    mkdir -p ~/.config/opencode/plugins
  2. 2

    Clone the repository into the plugins folder

    git clone https://github.com/FluxCapacitor2/opencode-desktop-go-usage
  3. 3

    Install dependencies inside the project folder

    bun install
  4. 4

    Build the plugin, then restart OpenCode Desktop if the badge does not appear

    bun run build

Things to know

  • Requires OpenCode Desktop and a signed-in OpenCode Console workspace to show usage data.
  • Relies on the app's usage endpoint, so it may break if that interface changes.

In collections

Desktop GUI apps & toolkits

Topics

#opencode#opencode-plugin#usage-monitor#typescript#desktop-app#developer-tools#opencode-desktop#opencode-v2

FAQ

What is opencode-desktop-go-usage?
An OpenCode Desktop plugin that shows your OpenCode Go monthly usage as a badge in the tab bar. This plugin adds a small badge to the OpenCode Desktop tab bar that displays your current OpenCode Go monthly usage as a percentage inside a circular progress ring. Hovering over the badge opens a tooltip with monthly, weekly, and 5-hour usage, average usage per day, the projected usage at the end of the subscription term, and the date the monthly limit resets.
Is opencode-desktop-go-usage free to use? What license does it have?
opencode-desktop-go-usage is open source under the MIT license. Check the license terms before using it in commercial products.
Is opencode-desktop-go-usage still maintained?
Actively maintained. The last commit to opencode-desktop-go-usage was on Oct 27, 2026.
What can I use opencode-desktop-go-usage for?
Keeping an eye on OpenCode Go quota while coding in OpenCode Desktop. Checking whether current usage is on track to last until the end of the billing month. Seeing when the monthly limit resets without opening the web console.
How do I install opencode-desktop-go-usage?
Create the OpenCode plugins folder: mkdir -p ~/.config/opencode/plugins Clone the repository into the plugins folder: git clone https://github.com/FluxCapacitor2/opencode-desktop-go-usage Install dependencies inside the project folder: bun install Build the plugin, then restart OpenCode Desktop if the badge does not appear: bun run build
Where can I get opencode-desktop-go-usage?
The source code and installation instructions are on GitHub: https://github.com/FluxCapacitor2/opencode-desktop-go-usage

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects