trails/.claude/skills/cmux-browser/references/proxy-support.md
Ullrich Schäfer b4c0ee954d
Add cmux skills (browser, debug-windows, markdown, core)
Skills for cmux terminal integration: browser automation for visual
verification, debug windows, markdown viewer, and core topology control.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 12:25:54 +01:00

1 KiB

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

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

Compare returned IP against expected proxy egress.