System

Architecture

Three parts: Host on your computer, Relay in the cloud (or local Docker), and the Termee App on your phone.

Phone App  --WSS-->  Relay  <--WSS--  Host Agent
                         |
                    HTTPS APIs / web

Pieces

Host — outbound WSS to Relay; runs approved PTY / agent sessions; never needs inbound ports for Alpha.
Relay — auth, pairing, session routing, account APIs, ops metadata, static web under /web/.
App — mobile client; pairs a Host, starts sessions, handles approvals.

HTTPS / WSS: https://staging.termee.ai / wss://staging.termee.ai/ws
Health: /healthz
Co-debug without new DNS: HTTP on the staging public IP for web/docs/ops (see Host upgrade doc)

Internal design wiki and evidence packs stay in the private repo; this page is the public-safe sketch only.