Headmesh Agent Sandbox for Gemini CLI

io.github.headmesh-dev/headmesh-sandbox

Run commands, edit files and manage Git and persistent sessions in your own isolated sandbox.

client:Gemini CLI transport:streamable-http

Install Headmesh Agent Sandbox in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

{
  "mcpServers": {
    "headmesh-sandbox": {
      "httpUrl": "https://{sandbox_host}/mcp"
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs