# headlesscode MCP server

> A coding-agent harness that executes tasks, manages parallel Git worktree workers, and supports recursive self-improvement through sandboxed sessions.

- Repository: https://github.com/Capsize-Games/headlesscode
- Page: https://hostedmcp.org/servers/capsize-games/headlesscode
- Transport: —
- Stars: 2
- License: Apache-2.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GH_TOKEN` | no | no |  |
| `HEADLESSCODE_LLM_PROVIDER` | no | no |  |
| `HEADLESSCODE_MUSE_API_KEY` | no | no |  |
| `HEADLESSCODE_OPENROUTER_API_KEY` | no | no |  |
| `HEADLESSCODE_OPENSHELL_POLICY` | no | no |  |

## FAQ

### What is the default security posture of headlesscode?

By default, it allows arbitrary command execution with the invoking user's privileges, including reading and modifying sensitive files like SSH or AWS credentials.

### How can I run headlesscode without an LLM API key?

You can use the `--dry-run` flag, which builds the system prompt and validates configuration without making model calls.

### Does headlesscode support MCP servers?

Yes, it can connect to user-configured stdio and Streamable HTTP MCP servers via a configuration file.

### What is OpenShell used for?

OpenShell runs worker and review sessions in disposable, sandboxed Git clones to provide containment.