flowmote

Flowmote bridge runs on the user's Mac. It pairs the mobile app with the local machine, connects to a Flowmote relay, and will own the local Codex runtime integration.

Current scope:

• Resolve bridge config from environment.
• Create and persist a local Mac device identity.
• Generate a short-lived pairing payload for the mobile app.
• Print a terminal QR, pasteable pairing payload, and short pairing code.
• Connect to the relay as the Mac side of a session.
• Register trusted-session resolve metadata with the relay.
• Proxy secure Codex traffic, approvals, git/workspace actions, voice, project browsing, desktop handoff, notifications, and pet metadata.

Usage

Start a local relay in one terminal:

npm run relay:start

Start the bridge in another:

npm run bridge:start

By default the bridge connects to the hosted Flowmote relay:

wss://igvuvqsnvxtr.sealosgzg.site/relay

Override it with:

FLOWMOTE_RELAY=ws://127.0.0.1:9100/relay npm run bridge:start

CLI

flowmote up
flowmote config
flowmote reset-pairing
flowmote version

Useful debug option:

flowmote up --print-pairing-json

The printed QR, pasteable payload, and pairing JSON contain sensitive pairing material and should only be used for local debugging.

State

Default state file:

~/.flowmote/device-state.json

Override with:

FLOWMOTE_DEVICE_STATE_DIR=/path/to/dir
FLOWMOTE_DEVICE_STATE_FILE=/path/to/device-state.json