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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools