trails/.agents/skills/cmux-browser/references/proxy-support.md
Ullrich Schäfer 19f2275b73 Move skills to .agents/skills for cross-agent compatibility
Skills now live in .agents/skills/ — the standard convention
aligned with Pi, OpenAI Codex, and the Agent Skills spec.

.claude/skills is a symlink back to .agents/skills/ so Claude
Code still discovers them.

Updated CLAUDE.md to document the setup.
2026-06-09 13:31:20 +02: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.