@opencode-trace/viewer

opencode-trace Web viewer for visualizing AI session trace data.

Installation

# Global install
npm install -g @opencode-trace/viewer

# Or use npx (no installation required)
npx @opencode-trace/viewer

Usage

# Start Viewer
npx @opencode-trace/viewer

# Or (if globally installed)
opencode-trace-viewer

# Or (via CLI)
opencode-trace viewer

# Start Viewer with custom trace directory
opencode-trace-viewer -d /path/to/traces

# Start Viewer on a custom port without opening the browser
opencode-trace-viewer -p 4000 -n

After starting, browser automatically opens (default http://localhost:3210).

Options

| Option | Description | |--------|-------------| | -p, --port <num> | Specify port (default 3210) | | -n, --no-open | Don't auto-open browser | | -d, --trace-dir <path> | Read trace data from custom directory (default ~/.opencode-trace) |

Features

Session Management

• Session list (supports tree view)
• Session search and filtering
• Session export/import (ZIP format)
• Session deletion (cascade delete sub-sessions)

Timeline View

• Request sequence visualization
• Change comparison (added/deleted messages and Blocks)
• Token usage statistics (per request)
• Latency metrics (TTFT, TPOT)

Record Details

• Complete request/response content
• Block classification (text, thinking, tool_call, image, etc.)
• SSE stream data display
• Error information display

Trace Control

• Global trace switch
• Session-level trace switch
• Real-time status display

API Endpoints

Viewer provides RESTful API:

| Endpoint | Description | |----------|-------------| | GET /api/sessions | List sessions | | GET /api/sessions/tree | Session tree | | GET /api/sessions/:id/timeline | Timeline data | | GET /api/sessions/:id/metadata | Session metadata | | GET /api/sessions/:id/records/:rid | Record details | | POST /api/sessions/import | Import ZIP | | GET /api/sessions/:id/export | Export ZIP | | DELETE /api/sessions/:id | Delete session | | POST /api/trace/enable | Enable tracing | | POST /api/trace/disable | Disable tracing | | GET /api/trace/status | Trace status |

Data Source

Viewer reads from ~/.opencode-trace/ directory by default.

Can specify custom directory via environment variable OPENCODE_TRACE_DIR.

License

MIT