Token Usage

v1.0.0Observability

opencode-token-usage

OpenCode plugin that tracks per-session token usage (input, output, reasoning, cache, cost) in the sidebar

Actively maintained

#opencode #opencode-plugin #tokens #token-usage #cost #cache

GitHub repo npm page

GitHub stars

Monthly installs

161

17 in 7 days

Composite scoreSCORE

32.3

Multi-signal model

Last commit

29 days ago

2026-07-22

Install and configure

opencode.json

Writes to this project's opencode.json — applies to this repository only.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-token-usage@1.0.0"]
}

Writes to ~/.config/opencode/opencode.json — applies to every project.

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-token-usage@1.0.0"]
}

opencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.

README.md

View original→

An OpenCode plugin that tracks per-session token usage and displays it in the sidebar.

Features

Tracks input, output, reasoning, cache read, and cache write tokens per session
Calculates cache hit rate as a percentage
Displays total cost per session
Updates in real-time as you chat
Persists data across sessions in ~/.opencode/token-usage.json
Shows clean values when no session is active

Installation

1. Install npm package

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

2. Register TUI sidebar plugin

Add to your ~/.config/opencode/tui.json:

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

3. Restart OpenCode

The Token Usage section will appear in the right sidebar of any active session.

How it works

Server plugin

Listens for message.updated events on completed assistant messages and accumulates token data per session ID into ~/.opencode/token-usage.json.

TUI plugin

Polls the current route every 500ms and reads the shared data file to display reactive token counts in the sidebar.

Data file

Stored at ~/.opencode/token-usage.json:

{
  "sessions": {
    "ses_xxx": {
      "input": 8475,
      "output": 26,
      "reasoning": 0,
      "cacheRead": 8192,
      "cacheWrite": 0,
      "cost": 0
    }
  }
}

License

MIT