Cmuxlayer

cmuxLayer

cmuxLayer exposes a 10-tool public MCP surface for controlling cmux terminal workspaces and managing CLI agents.

[](https://github.com/EtanHey/cmuxlayer#quick-start) [](LICENSE) [](https://modelcontextprotocol.io) [](#testing)

Quick start

brew install etanhey/layers/cmuxlayer       # stable, pinned release
brew install --HEAD etanhey/layers/cmuxlayer # or: dogfood the latest main

This installs the `cmuxlayer` command plus `cmuxlayer-app-server` and `cmuxlayer-proxy`. [cmux](https://github.com/manaflow-ai/cmux) must be running. For fleet wiring, versions, dogfooding, and the `CMUX_SOCKET_PATH` pin, see [docs/releases-and-brew.md](docs/releases-and-brew.md).

Then set up this machine:

cmuxlayer init

The wizard selects spawnable repositories, per-repo launchers or direct CLI launches, and approval behavior. It writes `~/.config/cmuxlayer/env.sh` and, in launcher mode, a launcher registry. cmuxlayer reads both at startup, including when an MCP client starts it from a GUI. The wizard asks before replacing a file and creates a backup first.

For scripted installs, pass `--yes` with `--repo =`. cmuxlayer does not assume a fixed repository layout. See [docs/fresh-install.md](docs/fresh-install.md) for the walkthrough and [docs/registry-optional-spawn.md](docs/registry-optional-spawn.md) for how each lane behaves.

Optional fleet sidebar

Install the optional lane-grouped fleet view with:

bun run install:fleet-sidebar

cmuxLayer refreshes `~/.config/cmux/sidebars/fleet.swift` from its r