Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Web Dashboard

The manager includes a web dashboard for visual sandbox management. Access it via claude-remote ui (SSH tunnel) or directly if you can reach the manager’s listen address.

Dashboard — sandbox list with live screenshots and system metrics

Features

  • Sandbox list — all sandboxes with status badges, backend type, and creation time
  • Live screenshots — captured every 2 seconds from Xvfb or QEMU QMP
  • Sandbox detail — individual page with live screenshot feed, Claude session metrics, and real-time log viewer
  • Real-time log streaming — WebSocket-powered terminal view of sandbox tmux output
  • Create form — HTML form for creating new sandboxes
  • System metrics — CPU, memory, disk usage

Sandbox Detail

Sandbox detail — live screenshot, Claude metrics, and WebSocket log viewer

Each sandbox detail page shows:

  • Sandbox info — ID, backend, project directory, network status, display number, tmux session
  • Live screenshot — auto-refreshing Xvfb or QEMU screendump
  • Claude metrics — messages, input/output tokens, cache stats, tool uses (parsed from Claude’s JSONL session files)
  • Log viewer — real-time streaming of the sandbox’s tmux output via WebSocket, with connection status indicator and auto-scroll

Technology

The dashboard is server-rendered HTML with htmx for auto-refreshing fragments. There is no JavaScript build step — htmx and CSS are vendored as static files, and HTML templates are compiled into the binary via askama.

Log streaming uses a WebSocket endpoint (/ws/sandboxes/<id>/logs) that tails the sandbox’s tmux pipe-pane log file and pushes new lines to connected clients in real time.

htmx fragments

The dashboard uses htmx polling to keep content fresh without full page reloads:

Fragment endpointDescription
/fragments/sandbox-listSandbox list on the index page
/fragments/system-metricsSystem metrics display
/fragments/sandboxes/<id>/claude-metricsClaude session metrics for a sandbox
/fragments/sandboxes/<id>/screenshotLive screenshot <img> tag

WebSocket endpoint

EndpointDescription
/ws/sandboxes/<id>/logsReal-time log stream (sends last 1000 lines as backlog, then new lines as they appear)

REST endpoint

EndpointDescription
/api/sandboxes/<id>/logsFull log file as text/plain

Pages

URLDescription
/Index — sandbox list + system metrics
/newCreate sandbox form
/sandboxes/<id>Sandbox detail — screenshot + metrics + log viewer