opencode-session-elapsed

A OpenCode TUI plugin that shows live timers in the prompt line:

• ◷ Session elapsed: how long the current session has been open
• ⚙ Work time: total time the assistant has been generating (cumulative across the session)
• ⚡ Response time: time for the current/last response (live while generating, then finalized)

  ◷ 2h 3m   ⚙ 1h 12m   ✓ 45s

All timers are optional, configurable, and safe to keep on: they disappear automatically when there is nothing to show.

Requirements

• OpenCode ≥ 1.18.0 (TUI mode)
• macOS / Linux / Windows

Install

From npm

Add the plugin to the TUI config in ~/.config/opencode/tui.json:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["opencode-session-elapsed"]
}

Restart OpenCode. Done: you'll see the timers in the prompt line.

From source

Clone the repo and reference the plugin file directly:

git clone https://github.com/siriscmv/opencode-session-elapsed.git

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["file:///path/to/opencode-session-elapsed/src/index.tsx"]
}

Restart OpenCode. Done: you'll see the timers in the prompt line.

Configure

Pass options as a tuple entry. All options are optional; defaults are shown below.

{
  "plugin": [
    [
      "opencode-session-elapsed",
      {
        "timers": { "session": true, "work": true, "response": true },
        "format": "compact",
        "icons": true,
        "slot": "session_prompt_right",
        "order": 200,
        "refreshMs": 1000,
        "colors": {
          "session": "#22c55e",
          "work": "#3b82f6",
          "response": "#f59e0b",
          "responseDone": "#22c55e"
        }
      }
    ]
  ]
}

Options

Option	Type	Default	Description
timers	{ session?, work?, response? }	all true	Toggle each timer independently.
format	"compact" | "full"	"compact"	compact → 1h 5m, full → 1:05:33 (clock-style, zero-padded).
icons	boolean	true	Show the ◷ ⚙ ⚡ ✓ glyphs.
slot	"session_prompt_right" | "home_prompt_right" | "sidebar_footer" | "app_bottom"	"session_prompt_right"	Which part of the TUI the timers render in.
order	number	200	Slot ordering relative to other plugins. Lower renders first.
refreshMs	number	1000	Update interval in milliseconds (minimum 250).
colors	{ session?, work?, response?, responseDone? }	theme colors	Hex color overrides (e.g. #22c55e) for each timer's icon.

Examples

Only the session timer, clock format, in the sidebar footer:

{
  "plugin": [
    [
      "opencode-session-elapsed",
      { "timers": { "session": true, "work": false, "response": false }, "format": "full", "slot": "sidebar_footer" }
    ]
  ]
}

Minimal, no icons:

{
  "plugin": [["opencode-session-elapsed", { "icons": false }]]
}

How it works

The plugin subscribes to TUI session state and ticks a 1s timer:

• Session elapsed: now minus the session's time.created.
• Work time: sums assistant.time.completed - assistant.time.created over every assistant message; the in-progress message is counted live while the session is busy.
• Response time: time from the last user message to the last assistant message completion (or the live elapsed time while still generating).

Development

bun install
bun run typecheck   # TypeScript checks
bun test            # unit tests (formatting)
bun run build       # bundle to dist/ (run before publishing)

License

MIT © Siris