Split Pane Display - Claude Code
Run each teammate in its own tmux or iTerm2 pane.
Split pane display gives each agent team member its own terminal pane, so you can see what every teammate is doing at the same time.
What it does
Claude Code launches a pane per teammate (tmux or iTerm2). Each pane shows that agent's live output, tool calls, and status. You watch the team collaborate in real time instead of reading a combined log stream. The lead's pane typically sits at the top.
When to use it
- Demos and recordings where "look at the team working" is the point.
- Debugging a team run when you need to see per-agent state.
- Understanding how work actually distributes in practice.
- Teaching others what multi-agent orchestration looks like.
Gotchas
- Lots of panes on a small screen become unreadable. Cap teammates or switch to summary mode.
- tmux-style panes require a tmux session. iTerm2 panes need iTerm2.
- Output can scroll fast. Record the session if you want to review later.
Official docs: https://code.claude.com/docs/en/agent-teams.md#choose-a-display-mode
Technical content at the intersection of AI and development. Building with AI agents, Claude Code, and modern dev tools - then showing you exactly how it works.
Get the weekly deep dive
Tutorials on Claude Code, AI agents, and dev tools - delivered free every week.
Was this helpful?
