opencode-viewer

Local GUI to browse your OpenCode sessions, messages, and tool calls from the SQLite database.

One command. No setup. Just run it.

bunx @virmont/opencode-viewer

What it does

Opens a local web UI to explore your OpenCode history stored in ~/.local/share/opencode/opencode.db:

• Projects — all your git repos tracked by OpenCode
• Sessions — conversation history per project, newest first
• Messages — full thread with user/assistant messages
• Tool calls — see every edit, read, bash, glob call with inputs/outputs
• Subagents — interleaved in the timeline, click to drill in, back to return
• Images — screenshots and attachments rendered inline with click-to-expand lightbox
• Reasoning — model thinking in collapsible blocks
• Patches, file attachments, compaction markers — all rendered

Requirements

• Bun runtime (curl -fsSL https://bun.sh/install | bash)
• OpenCode installed and used at least once

Usage

# Just run it — auto-opens browser
bunx @virmont/opencode-viewer

# Custom port
bunx @virmont/opencode-viewer -p 8080

# Custom database path
bunx @virmont/opencode-viewer --db /path/to/opencode.db

# Don't auto-open browser
bunx @virmont/opencode-viewer --no-open

# Show help
bunx @virmont/opencode-viewer --help

How it works

1. Reads your local opencode.db SQLite database (read-only, never writes)
2. Starts a lightweight Bun server on localhost:3456
3. Serves a single-page HTML app — no build step, no dependencies
4. All data stays local. Nothing leaves your machine.

Features

Three-panel layout

• Left — Project list with colored indicators
• Middle — Sessions for selected project, paginated
• Right — Full message thread with all parts

Message parts rendered

Part type	Rendering
text	Markdown-lite with code blocks
reasoning	Collapsible thinking block
tool	Tool name + status badge + input/output + execution time
patch	Compact card with commit hash + changed files
file	Attachment card, images rendered inline
agent	Subagent pill badge
step-finish	Muted cost/token summary line
compaction	Context compacted separator

Navigation

• Click a subagent card to drill into its messages
• Back button or Escape to return to parent session
• Escape also deselects session/project
• Click images for full-size lightbox

Stack

• Runtime: Bun (for bun:sqlite and Bun.serve())
• Frontend: Vanilla HTML/CSS/JS — zero dependencies, single file
• Database: SQLite read-only via bun:sqlite
• Total size: ~16KB packed

License

MIT