A tiny OpenCode plugin that adds a /usage slash command. It reads OpenCode's own local SQLite database and shows your token + cost usage for today / this week / this month / all-time, plus a per-model breakdown, in a dialog.

OpenCode Usage  ·  1,205 messages  ·  114.54M tokens  ·  $145.91 all-time
generated 2026-01-15 14:32

              MSGS    INPUT   OUTPUT     CACHE      COST
Today           41   192.4K    33.5K     3.76M     $4.90
This Week      299    1.37M   233.9K    26.53M    $37.88
This Month     768    3.49M   583.7K    68.10M    $94.88
All Time     1,205    5.50M   925.6K   108.11M   $145.91

MODELS
                              MSGS   INPUT   OUTPUT    CACHE     COST
anthropic/claude-sonnet-4-5    715   3.26M   552.1K   64.75M   $85.77
openai/gpt-5                   490   2.24M   373.4K   43.37M   $60.13

Install

Option 1: one-line installer

curl -fsSL https://raw.githubusercontent.com/anxkhn/opencode-usage/main/install.sh | bash

Option 2: let OpenCode install it

Paste this into OpenCode and let the agent do it:

Install the opencode-usage tool by reading and following
https://raw.githubusercontent.com/anxkhn/opencode-usage/main/INSTALL.md

Option 3: manual

git clone https://github.com/anxkhn/opencode-usage
cd opencode-usage
cp usage.mjs        ~/.config/opencode/usage.mjs
cp usage-plugin.ts  ~/.config/opencode/usage-plugin.ts
chmod +x ~/.config/opencode/usage.mjs

Then declare the plugin in ~/.config/opencode/tui.json (this is required: TUI plugins are not auto-discovered from a directory). Create the file, or add the entry to your existing plugin array:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["./usage-plugin.ts"]
}

Fully quit and reopen OpenCode so it loads the plugin. OpenCode auto-installs the small @opencode-ai/plugin dependency on startup.

Use it

In the OpenCode TUI, type:

/usage        # also available as /cost or /tokens

A dialog pops up with today / this week / this month / all-time and your per-model breakdown. Press enter or esc to dismiss it.

Optional terminal CLI

usage.mjs also runs standalone if you ever want it outside the TUI:

node ~/.config/opencode/usage.mjs            # full overview + recent days
node ~/.config/opencode/usage.mjs today      # one window
node ~/.config/opencode/usage.mjs week
node ~/.config/opencode/usage.mjs month
node ~/.config/opencode/usage.mjs all
node ~/.config/opencode/usage.mjs daily      # per-day table (last 30 days)
node ~/.config/opencode/usage.mjs models     # per-model breakdown

How it works

usage.mjs            engine + CLI (reads the DB, aggregates, formats)
usage-plugin.ts      TUI plugin: registers the /usage slash command
tui.json             declares the plugin so the TUI loads it
test/plugin.test.mjs verifies registration + rendering with a mock host

OpenCode's TUI only loads plugins listed in tui.json, so the installer adds ./usage-plugin.ts there (dropping a file in plugin/ is not enough for a TUI plugin). Every assistant message OpenCode stores carries its own cost and tokens (input, output, reasoning, cache read/write) plus a timestamp. usage.mjs reads those rows read-only, drops messages that did no billable work, buckets the rest by local day/week/month, and prints aligned totals. OUTPUT folds in reasoning tokens; CACHE is cache read + write. The reader prefers bun:sqlite (OpenCode's runtime) and falls back to node:sqlite, so the CLI also works under plain Node 22+.

Non-default data location

The database path is resolved the way OpenCode resolves it. Override it if your data lives elsewhere:

• OPENCODE_DB — full path to opencode.db
• OPENCODE_DATA_DIR or XDG_DATA_HOME — the OpenCode data directory

Test

node test/plugin.test.mjs

Uninstall

rm -f ~/.config/opencode/usage.mjs ~/.config/opencode/usage-plugin.ts

Then remove the "./usage-plugin.ts" entry from ~/.config/opencode/tui.json.

License

GPL-3.0