Skip to content
MCP server

Headmesh Agent Sandbox

Persistent sandbox for coding agents: run commands, edit files, manage Git and sessions

Pricing
Open source
Platforms
self-hosted, Linux, CLI
Runs
Remotely
Version
0.1.0
Listing updated
3 days ago

About Headmesh Agent Sandbox

Headmesh Agent Sandbox is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

This sandbox is a long-lived Docker container that joins a Headscale network as its own tagged node, so cloud agents can work on real files and private services without being handed the whole network. Agents connect through an MCP daemon called headmesh-sandboxd, and also by the Claude self-hosted runner, Codex over SSH and other routes.

The README reports 31 tools verified with tools/list, including exec, session management backed by tmux and file operations. Sessions persist across reconnects, home directories survive recreation, and a stricter YOLO profile is refused without a fresh backup record, mounts the host read-only per subtree and halts itself at its time limit. It also lists security findings, such as installing an egress firewall before enrolment.

The parent Headmesh project is in early development with a waitlist, and the README notes tailnet enrolment checks were still failing at the time of its verification date, so treat this as pre-release self-hosted software.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

exec
No description

What it does

Persistent container
Home directory and sessions survive reconnects and recreation.
Own mesh identity
Joins the network as a separate tagged device.
MCP daemon
Exec, sessions and file tools, 31 in total.
Two profiles
Regular and a time-limited, backup-gated YOLO mode.
Egress firewall
Host units limit what the container can reach.
Multiple front doors
MCP, SSH and agent runners.

Good for

  • Give a cloud agent a persistent workspace on your hardware
  • Let an agent reach one NAS and nothing else
  • Run long commands in tmux sessions an agent can resume
  • Edit and commit code in an isolated container

Pricing

Open source

Open source and self-hostable; early development

Prices change. Check headmesh.dev before you buy.

Headmesh Agent Sandbox FAQ

Is it production ready?

No; the project says early development and the README lists unfinished enrolment checks.

What base image does it use?

Ubuntu 26.04, pinned by digest.

How many tools?

31 reported by tools/list.

How is full access limited?

YOLO is opt-in, time-limited and blocked without a fresh backup.

Is Headmesh Agent Sandbox free?

Yes. Headmesh Agent Sandbox is open source, so you can use and self-host it for free.

What are the best alternatives to Headmesh Agent Sandbox?

The closest alternatives to Headmesh Agent Sandbox are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Headmesh Agent Sandbox

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools