surf-cli
View on GitHubThe CLI for AI agents to control Chrome. Zero config, agent-agnostic, battle-tested.
Surf is a zero-config CLI that lets AI agents control Chrome and other browsers via Unix-socket commands, no MCP relay or API keys required. It offers page reading, screenshots, network capture, remote Tailscale access, and also ships an MCP server.
Use Cases
Let AI agents drive Chrome via simple CLI commands over a Unix socketRead page content as an accessibility tree plus visible text for agent contextAuto-capture and token-optimized screenshots after each actionCapture, filter, search, and export network requests as HARClick elements, fill forms, and navigate tabs from an agent loopQuery ChatGPT, Gemini, Perplexity, and Grok using existing browser logins instead of API keysExpose browser control to agents through a bundled MCP serverRun agent browser actions remotely over Tailscale with Ed25519-authenticated credentialsAudit performance and run JS in a live page from an agentCross-browser support including Brave, Edge, Arc, and Helium
Built With
- Language
- TypeScript
- Frameworks
- Model Context Protocol SDK · Vite · Vitest · Biome · Zod · Puppeteer · Google Generative AI SDK · TypeBox
Tags
browser-automation · chrome · cli · computer-use · agent-tools · cdp · devtools · mcp · network-capture · screenshots · accessibility-tree · multi-browser · tailscale · zero-config · typescript · ai-agents