Build your team of agents

A dedicated workspace for your coding agents.

Build, coordinate, and navigate a team of coding agents from one agent-aware communication plane. See what every agent is doing and jump directly to the one that needs you.

Then run tmux-ide appDocs →GitHub545

Animated production tmux-ide OpenTUI showing agent status, terminal panes, window controls, and the command palette — Fig. 01.Production OpenTUI / sessions, agents, panes, and commandsMethod notes →

one workspace, every agent accounted for

Name them. See their state. Go straight to the right pane.

A clear three-step loop replaces terminal hunting with a workspace the whole team can understand.

namemonitornavigate

01Name

Memorable names instead of pane IDs

New agents and panes get human names such as talented-toucan and warm-redwood. Rename them at any time, then use those names when people and agents coordinate work.

Fig. 02.1.Agent identity / memorable naming

02Monitor

Live agent indicators

Working, idle, attention, and done states appear in the sidebar and pane chrome, so a multi-agent workspace remains readable without opening every terminal.

Fig. 02.2.Agent state / live indicators

03Navigate

Exact agent-to-pane navigation

Click an agent or choose it from the keyboard. tmux-ide resolves the exact session, window, and pane before transferring focus—no scanning a wall of terminals.

Fig. 02.3.Agent routing / exact pane focus

durable by architecture

Close the interface. Disconnect SSH. Your agents keep running.

tmux has already absorbed years of terminal, resize, shell, disconnect, and remote session edge cases. Its commands and session vocabulary are also familiar to coding agents. tmux-ide builds on that shared language instead of introducing a private multiplexer protocol.

tmux

processes · PTYs · sessions · windows · panes

The durable source of truth

Fig. 03.1.tmux / durable process ownership

tmux-ide daemon

discovery · lifecycle · agent state · pane streams

A coherent workspace model

Fig. 03.2.Daemon / coherent workspace projection

OpenTUI

navigation · agent chrome · controls · input

The interface you operate

Fig. 03.3.OpenTUI / agent-aware control surface

Local terminalSSHsame durable tmux workspace

That makes tmux-ide legible to both humans and agents: inspect sessions, target a named pane, and communicate through established tmux primitives rather than teaching every agent a proprietary control plane.

everything remains ordinary tmux

Create, arrange, and operate without breaking flow.

The visual layer maps directly onto familiar tmux operations. Use it when it helps, then drop back to tmux whenever you want.

Create

Open clean windows and give agents, panes, and sessions names your team can remember.

new windows
memorable names

Fig. 04.1.Create / windows and names

Arrange

Split and resize the workspace while the real tmux layout remains the source of truth.

split panes
coherent resize

Fig. 04.2.Arrange / splits and resize

Operate

Focus exact agent targets and close panes deliberately without disturbing the session.

precise focus
explicit close

Fig. 04.3.Operate / focus and close

Every action remains inspectable from an ordinary tmux client.Explore all commands →

questions, answered

The important details.

Is tmux-ide a new terminal multiplexer?

No. tmux remains responsible for processes, PTYs, sessions, windows, panes, and persistence. tmux-ide is a visual, agent-aware control surface for the tmux sessions you already own.

What happens when I close tmux-ide?

Your work keeps running in tmux. Open tmux-ide again, attach with an ordinary tmux client, or reconnect over SSH and continue from the same durable session.

Which coding agents does it recognize?

The OpenTUI is designed to recognize major coding-agent processes and project their live state into agent-aware pane chrome and the workspace sidebar. Ordinary shells and terminal programs continue to work alongside them.

Can I jump directly to a specific agent?

Yes. Selecting an agent resolves its exact tmux session, window, and pane, then focuses that pane. Memorable automatic names make the same targets easier to identify and discuss.

Does it work over SSH?

Yes. The OpenTUI and tmux are terminal-native, so the same agent workspace, pane controls, navigation, and durable sessions remain available over SSH.

Do I need a workspace configuration file?

No. tmux-ide discovers ordinary live tmux sessions by default. A .tmux-ide/workspace.yml file is optional when you want a repeatable declarative layout.

ready when you are

Build your team of agents.

Install tmux-ide, open the app, and turn the tmux sessions you already use into one clear agent workspace.

Then run tmux-ide appRead the guide →