Back to Cmux

Proxy Support

skills/cmux-browser/references/proxy-support.md

1.38.11.0 KB
Original Source

Proxy Support

How proxy behavior works for cmux browser automation.

Related: commands.md, SKILL.md

Contents

Current Behavior

cmux browser uses WKWebView networking. Proxy behavior follows macOS/system networking and app process environment.

What Is Not Exposed via CLI

There is currently no first-class cmux browser proxy ... command for per-surface proxy routing.

Why: WKWebView does not provide CDP-style per-context proxy controls equivalent to Chrome automation stacks.

Workarounds

  1. Configure system/network-level proxy for the environment where cmux runs.
  2. Route traffic through an upstream gateway you control.
  3. Validate behavior with explicit IP checks.

Verification

bash
cmux browser open https://httpbin.org/ip --json
cmux browser surface:7 get text body

Compare returned IP against expected proxy egress.