opencode-token-stats

OpenCode plugin for querying token usage statistics from the local database.

Features

• Query token usage statistics by day, week, month, or model
• View session counts, input/output tokens, reasoning tokens, cache read/write tokens
• Track costs across different time periods
• Supports table and JSON output formats

Installation

npm install opencode-token-stats

Usage

This plugin provides a token_stats tool that can be used in OpenCode to query your token usage statistics.

Parameters

Parameter	Type	Required	Description
period	day | week | month | model	Yes	Time period for grouping statistics
limit	number	No	Number of periods to return (default: 30)
format	table | json	No	Output format (default: table)

Examples

Daily token usage:

{
  "period": "day",
  "limit": 7
}

Weekly breakdown:

{
  "period": "week",
  "limit": 4
}

Monthly summary:

{
  "period": "month",
  "limit": 12
}

Usage by model:

{
  "period": "model",
  "limit": 5
}

JSON output:

{
  "period": "day",
  "format": "json",
  "limit": 7
}

Output Format

Table Format (default)

Token Usage Statistics (day)

Period       | Sessions | Input    | Output   | Total    | Cost($)
----------------------------------------------------------------
2024-01-15   | 5        | 12,345   | 6,789    | 19,134   | 0.0234
2024-01-14   | 3        | 8,901    | 4,567    | 13,468   | 0.0156

Summary: 8 sessions | 32,602 tokens | $0.0390

JSON Format

{
  "period": "day",
  "summary": {
    "totalSessions": 8,
    "totalTokens": 32602,
    "totalInput": 21246,
    "totalOutput": 11356,
    "totalCost": 0.039
  },
  "data": [...]
}

Database Location

The plugin reads from the OpenCode SQLite database located at:

~/.local/share/opencode/opencode.db

Development

Prerequisites

• Node.js 18+
• TypeScript 5+

Build

npm run build

Type Check

npx tsc --noEmit

License

MIT