tapes

Deck

ROI dashboard for agent sessions. Track costs, tokens, and outcomes with richer metrics and modern TUI visuals.

Overview

The Deck TUI surfaces session summaries with cost-weighted token charts, period comparisons, and drilldown views for detailed analysis.

tapes deck

Metrics

Period comparisons, project tracking, efficiency metrics, and tool usage at a glance.

Demo Data

Seed a demo database and open Deck with sample sessions.

# Seed demo data and launch Deck
tapes deck --demo

# Overwrite the demo database
tapes deck --demo --overwrite
# Shorthand
tapes deck -m -f

Demo data is stored in tapes.demo.sqlite.

Navigation

Keyboard controls for navigating the TUI:

Session Drilldown

When you select a session, the drilldown view shows a split layout with the conversation timeline and minimap on the left and message details on the right. Navigate through individual messages to see metadata, token counts, and content.

Examples

# View with period selector
tapes deck --since 720h

# Sort by time descending
tapes deck --sort time --sort-dir desc

# Filter by status
tapes deck --status failed

# Filter by project
tapes deck --project my-app

Web Dashboard

Prefer a browser? Launch the web dashboard instead:

tapes deck --web

Opens on port 8888 by default. Use --port to customize.

Terminal Compatibility

Deck auto-detects your terminal's color capabilities and background theme. For terminals where detection fails (tmux, screen, SSH sessions), use the --theme flag to override:

# Force dark theme
tapes deck --theme dark

# Force light theme
tapes deck --theme light

Color Support

Deck gracefully degrades across terminal capabilities:

• TrueColor terminals: Full 24-bit color palette (iTerm2, Ghostty, modern terminals)
• ANSI256 terminals: Hand-picked fallback colors for older terminals
• NO_COLOR: Set NO_COLOR=1 to disable colors entirely

See no-color.org for the NO_COLOR standard.

CLI Reference

For all flags and options, see the deck command reference.