Agent Plugins Marketplace
← All plugins

vibesurfer

v0.2.0

Agent-native headless browser. Includes 2 skills and 1 MCP server.

CodexClaude Code2 Skills1 MCP serverstdio

By Frane BandovLicense: Apache-2.015 GitHub starsUpdated 6 days ago

Directory evidence

Runtimes
Codex and Claude Code
Parsed components
3 skill or MCP entries
Source updated
Sep 18, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install vibesurfer for Codex and Claude Code

Installs for the current user
codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add vibesurfer@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/frane/vibesurfer

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugin/.

Plugin files

plugin/
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/debug-failed-action/SKILL.md
├── skills/vibesurfer/SKILL.md
└── .mcp.json

Included Skills2

debug-failed-actionskills/debug-failed-action/SKILL.md

When your last `vs_act` returned an unexpected result (NOT_FOUND, no visible state change, suspected silent failure), run this skill with the action's pre-token. Pulls console errors, network failures, and current performance into one report.

vibesurferskills/vibesurfer/SKILL.md

Agent-native headless browser. 26 primitives over a Unix-socket wire protocol. Real WKWebView (macOS), WebKitGTK 6 (Linux), or WebView2 (Windows) — all three engines verified per-commit by a real-browser integration suite. Optimistic concurrency via state tokens; tree-delta wire format; durable session/page/auth state in SQLite.

MCP servers1

vibesurferstdio
command
vs
args
mcp

Plugin manifests2

plugin/.codex-plugin/plugin.json
{
  "name": "vibesurfer",
  "version": "0.2.0",
  "description": "Agent-native headless browser.",
  "author": {
    "name": "Frane Bandov",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/frane/vibesurfer",
  "repository": "https://github.com/frane/vibesurfer",
  "license": "Apache-2.0",
  "keywords": [
    "browser",
    "headless",
    "webkit",
    "stateful",
    "mcp",
    "automation"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "vibesurfer",
    "shortDescription": "Agent-native headless browser.",
    "longDescription": "Real WebKit/WebKitGTK/WebView2 engines under a Unix-socket wire protocol. 20 primitives, state-token concurrency, tree deltas, audit-by-construction, AES-256-GCM auth blobs. Requires the `vs` binary on PATH.",
    "category": "Browser",
    "websiteURL": "https://github.com/frane/vibesurfer"
  }
}
plugin/.claude-plugin/plugin.json
{
  "name": "vibesurfer",
  "description": "Agent-native headless browser.",
  "version": "0.2.0",
  "author": {
    "name": "Frane Bandov",
    "url": "https://github.com/frane"
  },
  "homepage": "https://github.com/frane/vibesurfer",
  "repository": "https://github.com/frane/vibesurfer",
  "license": "Apache-2.0",
  "keywords": [
    "browser",
    "headless",
    "webkit",
    "stateful",
    "mcp",
    "automation"
  ]
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[vibesurfer on Agent Plugins Marketplace](https://pluginsmp.com/plugins/vibesurfer)