flowmote-relay

Flowmote relay is the transport hop between the mobile app and the Mac bridge.

It does not run Codex, inspect repositories, execute git commands, or decrypt application payloads. Its job is to keep the phone and Mac bridge in the same session room and forward encrypted WebSocket messages.

Endpoints

• GET /health
• POST /v1/trusted/session/resolve
• POST /v1/pairing/code/resolve
• WS /relay/{sessionId}

WebSocket clients identify their role with either an x-role header or, for browser clients that cannot set WebSocket headers, a ?role= query parameter:

• mac
• iphone
• android
• mobile

Mac bridge connections may also send:

• x-flowmote-mac-device-id
• x-flowmote-resolve-token
• x-pairing-code
• x-pairing-version
• x-pairing-expires-at

Those headers let an already trusted mobile client resolve the current live session without scanning a fresh QR.

Hosted deployments also include fixed-window rate limits for HTTP routes, push routes, and WebSocket upgrades. Detailed health can expose relay counts, push state, and runtime pressure metrics.

Local Usage

npm run relay:start

Environment:

FLOWMOTE_RELAY_HOST=127.0.0.1
FLOWMOTE_RELAY_PORT=9100
FLOWMOTE_RELAY_DETAILED_HEALTH=true
FLOWMOTE_RELAY_TRUST_PROXY=false
FLOWMOTE_ENABLE_PUSH_SERVICE=false

Tests

npm run relay:test