> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mux

> Set up beads for Mux with a managed AGENTS.md section, optional layered instruction files, and Mux hooks

Use Beads with Mux through `AGENTS.md`, optional layered Mux instruction files, and Mux hooks.

```bash theme={null}
bd setup mux
bd setup mux --check
```

The default setup writes a managed Beads section to root `AGENTS.md`.

## Workspace and Global Layers

Mux also supports workspace and global instruction layers:

```bash theme={null}
bd setup mux --project
bd setup mux --global
bd setup mux --project --global
```

Project setup writes `.mux/AGENTS.md` and installs Mux hook files under `.mux/`:

* `.mux/init`
* `.mux/tool_post`
* `.mux/tool_env`

Global setup writes `~/.mux/AGENTS.md`.

## Remove

```bash theme={null}
bd setup mux --remove
bd setup mux --project --remove
bd setup mux --global --remove
```