Web UI Views

relay-tty offers four ways to view your sessions in the browser. Switch between them using the layout switcher in the top navigation.

Home (Session List)

The default view. Shows all active sessions as a list with:

• Session ID and command name
• Running status and uptime
• Last activity timestamp
• Throughput metrics (bytes/sec)

Click any session to open it in full terminal view.

Agent Dashboard

A mission-control view for monitoring AI coding sessions. Shows each running session as a card with:

• Agent name — automatically detected from the foreground process (Claude Code, Codex, Aider, etc.)
• Live sparkline — visual throughput indicator using rolling bps metrics
• Throughput stats — current bytes/sec and total bytes written
• Session metadata — working directory, uptime, last activity

Cards update in real-time via WebSocket session metrics broadcasts. Click any card to open the full session view.

Responsive layout: grid on desktop (up to 3 columns), stacked cards on mobile.

Grid Gallery

A tiled overview showing live terminal thumbnails for all sessions. Each cell renders a scaled-down live terminal.

1. Grid toolbar — sort sessions, toggle inactive, filter by project, create new sessions
2. Live terminal cells — each cell renders real terminal output, scaled to fit

• Thumbnails update in real-time
• Click a cell to select it for keyboard input
• Double-click a cell (or click the expand icon) to zoom it to full size
• Useful for monitoring multiple long-running processes at a glance

Per-session font size

Each session has its own font size, adjustable with Cmd+= / Cmd+- (or pinch-to-zoom on touch devices). The font size is persisted per session and shared across all views.

When you change font size, the terminal dimensions (columns and rows) are recomputed to fit the same container area at the new cell size — the container stays fixed while the text gets larger or smaller. A SIGWINCH is sent so the running program redraws at the new dimensions.

Lanes View

Side-by-side terminal panels in uniform cells. Each lane shows a different session.

• Adjust lane width and height from the toolbar
• Click a cell to select, double-click to zoom
• Per-session font size works the same as in Grid (Cmd+=/-, pinch-to-zoom)
• Useful for comparing output or watching related processes

Switching Views

Use the layout switcher icon in the navigation bar to toggle between Home, Agents, Grid, and Lanes views.