OpenCode Insight

A monitoring plugin for OpenCode that provides real-time observability into your AI coding sessions.

Features

• Overview Dashboard — 6 metric cards + token distribution + model usage + cache efficiency
• Timeline View — Scrollable list of messages and tool calls with inline detail expansion
• Real-time Updates — The fullscreen overlay auto-refreshes every 2 seconds (configurable via overlayRefreshIntervalMs)
• Sidebar Stats — Shows total cost (incl. subagents) and cache hit rate directly in the sidebar, below the entry button
• Theme Aware — Integrates with OpenCode's current theme

Installation

Add to your tui.json (or tui.jsonc):

{
  "plugin": ["@expnn/opencode-insight"]
}

The plugin field is an array. Each entry is either a string spec or a [spec, options] tuple — not an object. See Configuration.

Configuration

Pass options using the tuple form [spec, options] inside the plugin array. An object form like { "spec": { options } } is invalid — opencode will reject the whole tui.json and skip every plugin.

{
  "plugin": [
    ["@expnn/opencode-insight", {
      "sidebarRefreshIntervalMs": 20000,
      "overlayRefreshIntervalMs": 2000,
      "overlayNavPct": 15
    }]
  ]
}

For a local dev build, use a file:// spec instead of the package name:

{
  "plugin": [
    ["file:///absolute/path/to/opencode-insight/dist/index.js", {
      "sidebarRefreshIntervalMs": 20000,
      "overlayRefreshIntervalMs": 2000,
      "overlayNavPct": 15
    }]
  ]
}

There are two independent refresh intervals — don't confuse them:

| Option | Type | Default | Applies to | Description | |--------|------|---------|------------|-------------| | sidebarRefreshIntervalMs | number (ms) | 20000 | Sidebar stat line | How often the compact sidebar line (total cost + cache hit rate) polls for fresh data. Aggregation reuses a per-session cache and only refetches changed sessions, so a higher interval costs almost nothing. | | overlayRefreshIntervalMs | number (ms) | 2000 | Fullscreen overlay | How often the overlay re-renders while open. Lower = more live, higher = less API traffic. | | overlayNavPct | number (%) | 20 | Fullscreen overlay | Width of the overlay's left navigation bar as a % of terminal width. The right main panel takes the remaining 100 - overlayNavPct. Clamped to [10, 40]. Lower it on narrow screens to give the main panel more room. |

Both must be positive numbers; otherwise the default applies.

Usage

Click "🤖 Opencode Insight" in the sidebar to open the fullscreen overlay. The sidebar also shows a compact line — total cost (including subagents) and cache hit rate — that updates on the sidebarRefreshIntervalMs cadence.

To close the overlay:

• Press Esc or q, or
• Click the [X] Close button at the top-right of the overlay.

Overview Panel

| Card | Shows | |------|-------| | Total Tokens | All tokens consumed | | Cost | Total USD | | Input | Input tokens + cached | | Output | Output tokens + cached | | Cache | Cache read + write | | Tool Calls | Total tool call count |

Timeline Panel

Scrollable table of every message and tool call. Click any row to expand inline details — message content, reasoning, token breakdown, or tool I/O.

Screenshots

Troubleshooting

If the plugin doesn't load or shows stale code after reinstalling:

rm ~/.cache/opencode/packages/@expnn/opencode-insight@latest -rf

Then restart OpenCode.

Requirements

• OpenCode >= 1.17.3

License

MIT