Show and tell: opencodex-usage-meter — a read-only Hermes Desktop status-bar plugin for quota & usage

[Vocllum]

Hi! I built a small status-bar plugin that consumes the OpenCodex CLI's usage data, and wanted to share it here since it might be useful to other dashboard users.

opencodex-usage-meter — a read-only Hermes Desktop status-bar plugin (MIT).

Your pinned targets live in the status bar as glanceable chips — ChatGPT 6% | OpenCode Go 75%, colored by urgency — and hovering opens the full panel:

What it does:

• Focus board — pin any provider or a single account; it renders as a large card with a big remaining percentage. Pinned rows stay expandable in the list, deduplicated.
• Usage that answers real questions — 7d/30d/all tabs preloaded in parallel (instant switching), with requests / token breakdown / API-equivalent cost per range.
• Honest states — live-vs-cached dot, last-success time, manual refresh that bypasses the cache, visible truncation warnings.

It's purely a read-only consumer of ocx — no credentials touched, nothing written back.

One integration note for fellow plugin builders: because of #1497, on busy installs the 30d/all ranges can be bounded by the same usage tail. The plugin surfaces the upstream truncation warning rather than hiding it — worth knowing if you're also aggregating usage --json output.

Install steps are in the README. Feedback welcome!