Watch or take over an agent live

Most of the time an agent runs a turn and reports back. Tmux mode lets you go further: it hosts an agent's conversation in one long-lived Claude Code terminal, so you can watch it think and work in real time, and take the keyboard whenever you want to steer.

Turn on tmux mode

In the panel, open an agent's settings (Atlas, or any Lead or worker) and enable Tmux mode. From then on, that agent runs inside a named tmux session, myagens-<agent>, instead of a fresh headless run per message. The conversation survives bot restarts, and /new resets it.

Two requirements:

• Full autonomy. The terminal runs with permissions bypassed, so the agent must be set to Full autonomy.
• tmux on the host. The installer adds tmux on macOS and Linux. If it is missing, the toggle greys out with a hint, and turns quietly fall back to the normal path until it is installed.

Watch it work

You have three ways in, use whichever is closest to hand:

• In the panel. Each tmux-mode agent's card in the Agents view has a Terminal button that opens a live viewer, one click away. Expand it into a large centered cinema view sized so the full pane fits; press Esc or click the backdrop to close.
• From any terminal. Run tmux attach to the agent's session on the host and watch or type directly.
• From claude.ai and the Claude mobile app. Turn on the Remote Control sub-toggle (under Tmux mode) and the agent's turns appear under its own name at claude.ai/code and in the Claude mobile app, so you can watch and steer from your phone.

/status shows the agent's session, the attach command, and the mirror URL. Toggle Remote Control from Telegram with /rc on or /rc off, which reports the mirror URL and offers to restart the instance so the change applies.

Taking control, and handing it back

While you are watching, start typing to take over the keyboard, then stop and let the agent carry on. In the panel's cinema view, "Take control" keeps Esc with the terminal so your keystrokes reach the agent rather than closing the view.

What stays on the safe path

Tmux mode is for the interactive conversation. Delegated task cards, council votes, and scheduled runs always stay on the standard runner, so approvals, abortability, and timeouts keep working exactly as before. A single terminal turn is capped by TMUX_TURN_TIMEOUT_MS (ten minutes by default).

Frequently asked questions

Do I have to use tmux mode?

No. It is off by default and per agent. Leave it off and agents run the normal way, one turn per message with the full approval flow.

Can I take over from my phone?

Yes. With the Remote Control sub-toggle on, the agent shows up at claude.ai/code and in the Claude mobile app under its own name, so you can watch a live run and take the keyboard from anywhere.

Why does it need Full autonomy?

The persistent terminal runs Claude Code with permissions bypassed, which only makes sense at Full autonomy. If you want per-action approval, keep the agent on standard autonomy and leave tmux mode off.