Skip to main content
The Orchestrator Proxy lets a local client connect to an Assistant through RelayCloud. It runs on your local device and forwards HTTP, WebSocket, and server-sent event traffic to the selected Assistant.

​
Start the proxy

1

Sign in on your local device

If you have not already authenticated the device, run:
The proxy reuses the credentials saved by this command.
2

Start the proxy and select an Assistant

Run:
When you run the command without an Assistant ID in an interactive terminal, the Orchestrator opens a selector. Choose the Assistant you want to connect to, optionally filtering by project or workspace. The proxy listens on 127.0.0.1:4090 by default. Keep this command running while you use the local client.You can provide an Assistant ID directly instead:
3

Connect your local client

Point your local client at the proxy URL. For example, attach the OpenCode TUI with:
Other compatible clients can use the same URL as their server endpoint. Requests and Assistant events are forwarded through Relay to the Assistant selected when the proxy started.You can also open the proxy URL in your browser to use the Web UI.

​
Proxy options

Use --host and --port when you need a different local bind address or port:
If you omit --port and port 4090 is already in use, the proxy asks the operating system for an available port and displays the resulting URL. An Assistant ID is required when you run the proxy without an interactive terminal.