Vibesurfer is an agent-native headless browser designed for developers using AI coding agents such as Claude Code, Cursor, and Codex. With 26 primitives accessible over a Unix-socket wire protocol, it serves as a robust tool for enhancing agent capabilities through a seamless integration process.
What this skill does
Facilitates the connection between AI agents and headless browsers on various platforms including macOS (WKWebView), Linux (WebKitGTK 6), and Windows (WebView2).
Utilises optimistic concurrency with state tokens and a tree-delta wire format to ensure efficient communication.
Manages durable session, page, and authentication states through an SQLite database located at ~/.vibesurfer/state.db.
Provides a command-line interface (CLI) that operates through a daemon process, auto-spawned upon first call, to maintain a long-lived browser engine.
Easy installation via `npx vibesurfer`, enabling quick setup and integration into existing agent workflows.
Who it is for
This tool is designed for developers and teams who are utilizing AI coding agents such as Claude Code, Cursor, and Codex in their workflows. It caters to those who require a dependable method for enabling their AI agents to interact with web content programmatically.
Use cases
Developers needing to automate web page interactions in a headless mode for testing or data extraction purposes.
Teams integrating AI agents within continuous integration pipelines that require automated browser interactions.
Enhancing agent-based applications by embedding browser capabilities directly within AI skills.
Technical details
Operates using verified real-browser integration suites based on per-commit checks.
Offers a stateless CLI system which communicates over a Unix socket, allowing efficient execution of commands through short or long-form primitives.
Ensures operational transparency by writing an audit row for every primitive action performed, with no opt-out options.
Source & Licence
This package is built on open-source work published by frane (frane/vibesurfer) and distributed under Apache-2.0. The original licence text and copyright notice are included in your download.
Personal and commercial use, modification and redistribution are permitted under the Apache License 2.0, which also includes an express patent grant. Attribution and any NOTICE file must be retained.
Your purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.
Delivery & Support
Delivery: instant — a secure download link is emailed to you as soon as payment is confirmed.
Format: ZIP archive containing the skill files, documentation and the original licence.
Updates: updates are included only where stated on this page.
Refunds
This is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.
Claude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.