For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

doctl harness-runtime start-proxy [flags]

Description

Bridge a local coding-agent CLI to a hosted M.A.R.S session.

launch is doctl’s built-in chat. start-proxy is different: it runs a small local server that speaks the agent CLI’s own protocol — a WebSocket JSON-RPC server for Codex, an HTTP+SSE opencode server for opencode — so you can keep using the agent’s native UI while the sandbox lives on DigitalOcean.

Typical flow:

# terminal 1 — keep this running
doctl harness-runtime start-proxy --type codex --session my-session --port 1144

# terminal 2 — connect Codex to the proxy
codex --remote ws://127.0.0.1:1144

With --type opencode, connect the opencode TUI instead (--continue resumes the session’s prior turns):

opencode attach http://127.0.0.1:1144 --continue

The opencode bridge is tested against opencode 1.18.27; other versions usually work, and the proxy logs any request it does not recognize.

Only one of launch and start-proxy can stream the same session from one machine at a time.

Example

doctl harness-runtime start-proxy --type codex --session my-session --port 1144;

Flags

Related Commands

Global Flags