Skip to content
    ↑↓ select↵ openesc close
    English中文
    njbraun

    Session Token Summary

    v0.4.1Agent Orchestration
    opencode-plugin-session-token-summary

    OpenCode TUI sidebar showing token usage across a session and its subagents.

    Actively maintained
    #opencode#opencode-plugin#tui#tokens#usage#subagents
    GitHub reponpm pageHomepage
    GitHub stars

    3

    +1 in 30 days

    Monthly installs

    103

    27 in 7 days

    Composite scoreSCORE

    37.9

    Multi-signal model

    Last commit

    1 month ago

    2026-07-17

    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-plugin-session-token-summary@0.4.1"]
}

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

    README.md
    View original→

    npm version

    An OpenCode TUI plugin that adds a compact session-usage panel to the sidebar. It aggregates the root session and all nested subagent sessions.

    alt text

    Features

    • Compact OpenCode sidebar panel with live session updates
    • Input, output, reasoning, cache read, cache write, and total token counts
    • Cache hit ratio and assistant turn count
    • Usage aggregated across the root session and every nested subagent
    • Reported API costs for metered providers
    • API-equivalent cost estimates for quota and subscription-backed providers
    • One combined cost total for sessions that mix metered and quota-backed models
    • Clear labels distinguishing reported, estimated, and partially estimated costs
    • Models.dev-backed pricing with model alias matching and context-tier support
    • Bounded concurrent requests for nested subagent discovery
    • Race-safe refreshes that retain the last complete snapshot after API failures

    Requirements

    • OpenCode >=1.17.9

    Install

    Install this plugin through OpenCode's plugin installation flow:

    1. Press Ctrl+P in OpenCode and choose Install plugin.
    2. Press Tab to install globally.
    3. Enter opencode-plugin-session-token-summary without a version or @latest suffix.

    The installation creates an entry referencing this package in ~/.config/opencode/tui.json.

    This plugin is functional only in version 0.3.0 and later.

    Updating

    OpenCode does not currently support plugin updates reliably. See OpenCode PRs #35777, #32822, and #37300. To force OpenCode to download current plugin versions, clear its plugin cache:

    rm -rf ~/.cache/opencode

    Notes

    The panel obtains descendant aggregates from OpenCode's session API and fetches descendant messages to count their assistant turns. Requests are limited to four concurrent operations. A failed refresh leaves the last complete sidebar values in place rather than showing partial totals.

    Nonzero cost reported by OpenCode is shown as $ cost. For messages with an explicit zero cost, the plugin uses OpenCode's Models.dev-backed provider catalog to calculate what the same tokens would cost at published API rates. Fully estimated totals are shown as $ est. cost; totals that combine reported and estimated amounts are shown as $ cost incl. est. Quota or subscription users are not necessarily charged the estimated amount. If catalog pricing cannot be matched, only the reported cost is shown.

    Development

    npm install
npm run check
npm run pack:check

    License

    MIT