feat: add provider runtime launcher settings for agent CLIs

packages/website/src/routes/docs/configuration.tsx

@@ -78,6 +78,83 @@ function Configuration() {
         </pre>
       </section>
 
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">Agent provider runtime settings</h2>
+        <p className="text-white/60 leading-relaxed">
+          Use <code className="font-mono">agents.providers</code> to customize how Paseo launches agent provider CLIs.
+          This works for <code className="font-mono">claude</code>, <code className="font-mono">codex</code>, and
+          <code className="font-mono"> opencode</code>.
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          <code className="font-mono">command.mode</code> can be <code className="font-mono">default</code>,{' '}
+          <code className="font-mono">append</code>, or <code className="font-mono">replace</code>. Use{' '}
+          <code className="font-mono">env</code> to inject provider-specific environment variables.
+        </p>
+
+        <h3 className="text-lg font-medium">Enable Claude Code Chrome MCP</h3>
+        <pre className="bg-card border border-border rounded-lg p-4 font-mono text-sm overflow-x-auto text-white/80">
+{`{
+  "agents": {
+    "providers": {
+      "claude": {
+        "command": {
+          "mode": "append",
+          "args": ["--chrome"]
+        }
+      }
+    }
+  }
+}`}
+        </pre>
+
+        <h3 className="text-lg font-medium">Point Claude to Anthropic-compatible endpoints (z.ai example)</h3>
+        <pre className="bg-card border border-border rounded-lg p-4 font-mono text-sm overflow-x-auto text-white/80">
+{`{
+  "agents": {
+    "providers": {
+      "claude": {
+        "env": {
+          "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
+          "ANTHROPIC_AUTH_TOKEN": "auth token",
+          "ANTHROPIC_API_KEY": ""
+        }
+      }
+    }
+  }
+}`}
+        </pre>
+
+        <h3 className="text-lg font-medium">Run Claude through Docker</h3>
+        <p className="text-white/60 leading-relaxed">
+          Create a wrapper script that runs Claude in Docker, then tell Paseo to replace the Claude launch command
+          with that script.
+        </p>
+        <pre className="bg-card border border-border rounded-lg p-4 font-mono text-sm overflow-x-auto text-white/80">
+{`{
+  "agents": {
+    "providers": {
+      "claude": {
+        "command": {
+          "mode": "replace",
+          "argv": ["/Users/you/bin/claude-docker"]
+        }
+      }
+    }
+  }
+}`}
+        </pre>
+        <pre className="bg-card border border-border rounded-lg p-4 font-mono text-sm overflow-x-auto text-white/80">
+{`#!/usr/bin/env bash
+set -euo pipefail
+docker run --rm -i \\
+  -v "$PWD":"$PWD" \\
+  -w "$PWD" \\
+  -v "$HOME/.claude":"$HOME/.claude" \\
+  ghcr.io/anthropics/claude-code:latest \\
+  claude "$@"`}
+        </pre>
+      </section>
+
       <section className="space-y-4">
         <h2 className="text-xl font-medium">Voice</h2>
         <p className="text-white/60 leading-relaxed">