Tokenscope

TL;DR

Tokenscope (community plugin by @ramtinJ95) turns the telemetry OpenCode has persisted for a session into a readable report covering token usage, cache, context, and cost. It deliberately keeps recorded usage separate from local tokenization and explanatory estimates, so the output does not imply precision the source data cannot support. Install with npm install -g @ramtinj95/opencode-tokenscope, add @ramtinj95/opencode-tokenscope to the plugin array, then create the /tokenscope command.

Tokenscope provides token usage, cache, context, and cost analysis for OpenCode sessions, built on the telemetry OpenCode already persists.

Key features

Feature	Description
Session reports	Turns persisted OpenCode telemetry into a readable report
Honest numbers	Recorded usage kept separate from local tokenization and explanatory estimates
Cost tracking	Cost analysis alongside token, cache, and context views

Installation

1. Install globally:

npm install -g @ramtinj95/opencode-tokenscope

2. Add the plugin to opencode.json (project root or ~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@ramtinj95/opencode-tokenscope"]
}

3. Create the /tokenscope command at ~/.config/opencode/command/tokenscope.md — see the repository README for the command file content.