This repository wraps @vibebrowser/mcp as a Codex plugin that is ready for one-click installation in the Codex app.
It keeps the runtime thin on purpose:
- MCP server:
npx -y @vibebrowser/mcp@latest start - Plugin metadata:
.codex-plugin/plugin.json - Codex MCP wiring:
.mcp.json - A focused skill for driving the user's real browser
- A Codex-native plugin manifest for the Vibe Browser MCP server.
- A zero-code wrapper around the published
@vibebrowser/mcppackage. - A skill that teaches Codex to drive the user's real, already-logged-in Chrome — not a throwaway headless profile.
- Multi-agent friendly: the Vibe relay lets several agents share one browser session.
Codex -> vibe-browser MCP server (@vibebrowser/mcp) -> Vibe relay -> Vibe Chrome extension -> your real browser
The MCP server connects to the user's browser through the Vibe extension and relay (local or the public wss://relay.api.vibebrowser.app). Tools include navigate, accessibility snapshot, click, fill, type, screenshot, and tab management.
- Node.js 20.19+ (or a newer maintenance LTS) and
npx. - Google Chrome with the Vibe browser extension installed and external AI agent control enabled.
Add this repository as a Codex marketplace source, then install the vibe-browser plugin from it. See the upstream project for MCP and relay details: https://github.com/VibeTechnologies/vibe-mcp.
This wrapper ships no credentials and executes no bundled code; it only declares how Codex should launch the published MCP server. See SECURITY.md. The plugin is validated in CI with the HOL AI Plugin Scanner.