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 UI

cryo web starts a local web server with a chat interface for sending messages to your agent and monitoring its activity.

Usage

cryo web                         # default: http://127.0.0.1:3945
cryo web --port 8080             # custom port
cryo web --host 0.0.0.0          # listen on all interfaces (see warning below)

Warning: The web UI has no authentication. Binding to 0.0.0.0 exposes all endpoints (status, messages, wake) to the network. Only do this behind an authenticated, TLS-terminating reverse proxy.

Or configure in cryo.toml:

web_host = "127.0.0.1"
web_port = 3945

Features

  • Chat interface — Send messages to the agent’s inbox and see outbox replies
  • Status bar — Shows daemon status (running/stopped), session number, and agent name
  • Wake button — Force the daemon to wake immediately (sends SIGUSR1)
  • Live log — Toggle the log panel to see cryo.log events in real-time
  • Real-time updates — Server-Sent Events (SSE) stream new messages, status changes, and log lines as they happen
  • Polling fallback — Periodic polling ensures messages from the daemon are never missed

API Endpoints

The web server exposes a JSON API:

EndpointMethodDescription
/GETChat UI (HTML)
/api/statusGETDaemon status (running, session, agent, log tail)
/api/messagesGETAll messages (inbox + archived inbox + outbox), sorted by time
/api/sendPOSTSend a message to inbox ({ "body": "...", "from": "...", "subject": "..." })
/api/wakePOSTWake the daemon ({ "message": "..." })
/api/eventsGETSSE stream (events: message, status, log)