moot attach¶
Attach your terminal to a running agent’s tmux session.
Synopsis¶
moot attach <role>
Arguments¶
- role¶
The role to attach to. Must match a role defined in
moot.toml.
Description¶
moot attach connects your terminal to the tmux session for the named role
(moot-<role>) running inside the devcontainer. The session runs Claude Code
in interactive mode — you can type prompts, watch the agent’s output, and
observe or guide its work.
To detach without stopping the agent, use the tmux prefix followed by d.
The bundled .tmux.conf remaps the prefix to Ctrl-Space, so the default
detach sequence is Ctrl-Space d. You can also run moot detach <role>
from another terminal.
Auto-relaunch: If the named session is not running (for example, the agent
exited via /exit), moot attach relaunches the role before attaching.
This requires Claude Code credentials to already be present in the container.
If credentials are absent, run moot up first.
First-time login: moot up instructs you to run moot attach <role>
on the human-interface role (typically product) to complete /login and
theme setup during a cold start.
Examples¶
Attach to the product agent:
moot attach product
Attach to implementation to review ongoing work:
moot attach implementation
See also¶
moot up — start agents (handles cold-start login flow)
moot status — check which agents are running
moot compact — trigger context compaction without attaching