Token Usage

v1.0.0可观测与分析

opencode-token-usage

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

维护活跃

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

GitHub 仓库 npm 页面

GitHub 星标

月装机量

161

近 7 天 17

综合评分SCORE

32.3

生态多维模型

快速安装与配置

opencode.json

写入当前项目的 opencode.json，只对这个仓库生效。

opencode.json

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

opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

README.md

查看原始文件→

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