Skip to content

About

Track every models, especially free tiers.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

opencode-usage

how much free tier AI have you burned through today? little widget for the omarchy bar

usage card

what you get

  • 📊 today's tokens in the bar - fresh tokens up front,
  • 💰 how many $$$ of paid API calls your free traffic replaced
  • ✨ 7-day sparkline, per-provider free-tier limit rings, per-model rows
  • ⚙️ settings for basically everything, changes apply instantly
  • 🐭 left-click opens/closes, middle-click refreshes, right-click (or o) opens opencode - logo turns amber at 60% of any limit, red at 85%

settings

look settings
look - icon, size, colour, text
layout settings
layout - bar section, spacing, visibility
behaviour settings
behaviour - clicks, refresh timing
popup and data settings
popup & data - width, rows, budgets, db path

install

omarchy plugin add https://github.com/paudelsamir/opencode-usage.git --enable
install by hand instead

drop this folder into ~/.config/omarchy/plugins/, then

omarchy-shell shell rescanPlugins
omarchy plugin enable paudelsamir.opencode-usage

remove

omarchy plugin disable paudelsamir.opencode-usage
omarchy plugin remove paudelsamir.opencode-usage

needs

dependency why
opencode 1.x reads its local database (~/.local/share/opencode/opencode.db) - read-only, no network, no API keys, nothing leaves your machine
python3 (stdlib only) the bin/opencode-usage data script
models.dev catalog prices - opencode already caches it at ~/.cache/opencode/models.json
  • overrides (baseline, equivalents, free, paid) go in ~/.config/omarchy/agents/opencode.json.

Note

Only OpenCode 1.x's message table is read; OpenCode 2 beta will show an error.

About

Track every models, especially free tiers.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages