STOP. READ THIS ENTIRE SKILL.MD BEFORE CALLING ANY ENDPOINT.

Surf - Browser Automation for AI Agents

Two modes of operation:

1. With surf-cli extension (recommended): Full features, works with your existing browser
2. CDP fallback: Zero-config, but requires starting a separate Chrome instance

If /tmp/surf.sock exists (extension installed), all commands route through surf-cli. Otherwise, commands use CDP.

Runtime Entrypoint And PATH

The reliable agent entrypoint is the skill-local wrapper:

cd ${HOME}/workspace/experiments/agent-skills/skills/surf
./run.sh tab.list --json
./run.sh webgpt.preflight --tab-id <id> --expect-url <url> --no-activate --json