Camofox Browser is an open-source browser orchestration harness maintained by jo-inc, designed to bridge AI coding agents and LLM environments with automated browser instances. It serves as execution infrastructure that allows agents to interact with web applications, DOM structures, and dynamic web content through standard protocols. In daily developer workflows, Camofox Browser operates as a standalone CLI tool or as a Model Context Protocol (MCP) server connected to compatible agent platforms. It supports both headless operation using virtual framebuffers (Xvfb) and an opt-in interactive desktop browser mode, enabling agents to execute navigation, form filling, and DOM parsing while handling display lifecycle management. Camofox Browser differentiates itself by focusing on resilient browser execution and security hardening for agent environments. It includes safeguards such as strict asset sanitization against prompt-injection vectors and automated display teardown for virtualized sessions, avoiding process leaks in automation pipelines. The project is open source on GitHub and distributed via npm with active releases across the 1.x version line.
Model Context Protocol (MCP) server — Exposes browser automation capabilities as standard MCP tools to any compatible coding agent harness. - Dedicated CLI binary — Provides direct terminal commands for managing browser sessions and agent execution pipelines. - Interactive desktop browser mode — Offers an opt-in graphical interface for visually debugging agent web interactions. - Headless Xvfb and VNC integration — Manages virtual displays and VNC setups with automatic cleanup of Xvfb display files upon exit. - Package-level prompt-injection protection — Enforces pure ASCII distribution rules across package contents to minimize injection vulnerabilities.
Use cases
Use Case: Providing Web Browsing Capabilities to MCP Agents Developers attach Camofox Browser as an MCP server to terminal coding agents like Claude Code or Cursor, allowing the agent to fetch live web documentation, inspect APIs, and retrieve web context during coding tasks.
Use Case: CI/CD and Headless Browser Automation Engineers invoke Camofox Browser in automated headless pipelines with Xvfb, relying on its automated display cleanup to prevent leftover display lock files from failing subsequent build jobs.
Use Case: Visual Debugging of Web Agent Workflows Developers switch from headless execution to the opt-in interactive desktop mode to observe and troubleshoot dynamic page interactions and DOM traversal performed by the agent.
Who it is for
Camofox Browser is built for software engineers and AI platform developers who need an MCP-ready, automated browser runtime for agentic workflows. It is not a standalone code editor or LLM chat client, but rather an execution harness for agents that require web interaction.
Install guide
Installation Install the package globally via npm (standard installation based on npm package metadata in the repository): bash npm install -g camofox-browser Alternatively, clone and run from source: bash git clone https://github.com/jo-inc/camofox-browser.git cd camofox-browser npm install
First Run To run Camofox Browser as an MCP server for your coding agent, add the binary to your agent's MCP configuration JSON: json { "mcpServers": { "camofox": { "command": "camofox-browser", "args": ["mcp"] } } }
Example Session Launch the browser via the CLI binary directly in interactive mode: bash # Start Camofox Browser in interactive desktop mode camofox-browser --interactive
Skillreaper — Skillreaper is an open-source skill lifecycle management and auditing tool for AI agent ecosystems, developed by thousandflowers. It analyzes agent…
ActPlane — ActPlane is an open-source agent execution and policy enforcement harness developed by the Eunomia-bpf organization. It functions as a security…
Zosma QA — Zosma QA is an open-source testing-focused agent harness and orchestration framework created by Zosma AI. It provides scaffolding, structured prompt…
Stratless — Stratless is an open-source agent harness and execution orchestrator developed by the Stratless AI team. It provides a modular infrastructure…
Agent Island — Agent Island is an open-source agent orchestration harness created by developer tristan666666 on GitHub. Designed as a framework for running…
Repo Forensics — Repo Forensics is an open-source agent orchestration harness and repository security gating tool developed by Alex Greenshpan (alexgreensh). Designed to…