# Headmesh Agent Sandbox

> Headmesh Agent Sandbox is an open-source MCP server for developer tools. Persistent sandbox for coding agents: run commands, edit files, manage Git and sessions. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, Linux, CLI
- **Website:** https://headmesh.dev
- **Repository:** https://github.com/headmesh-dev/headmesh/tree/HEAD/sandbox
- **MCP Registry name:** io.github.headmesh-dev/headmesh-sandbox
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Tools

- `exec`

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/headmesh-agent-sandbox
