Keyboard Shortcuts

Quick reference for all keyboard commands when working with agent teams.

Fresh 🌱

Team Navigation (In-Process Mode)

Shortcut	Action	Notes
Shift+Up	Previous teammate	Cycles backward through team members
Shift+Down	Next teammate	Cycles forward through team members
Shift+Tab	Toggle delegate mode	Restricts lead to coordination only

Teammate Interaction (In-Process Mode)

Shortcut	Action	Notes
Enter	Enter teammate session	You're now in their view/context
Escape	Exit teammate session	Returns to team lead view
Escape (while in session)	Stop teammate's current action	Interrupts what they're doing

Task Management (In-Process Mode)

Shortcut	Action	Notes
Ctrl+T	Show/hide task list	Toggles visibility of shared tasks

Terminal Navigation

Shortcut	Action	Notes
Ctrl+C	Terminate session	Forcefully kills Claude Code
Ctrl+D	Exit session gracefully	Clean shutdown if allowed

Split Panes Mode (tmux/iTerm2)

Shortcut	Action	Notes
Mouse click	Click into pane	Select which teammate to interact with
Alt+Arrow	Switch pane focus	tmux: navigate between panes
Ctrl+B + D	Detach tmux session	Exit while keeping session alive

macOS-Specific Shortcuts

Shortcut	Action	Notes
Cmd+T	New terminal tab	Outside Claude Code
Cmd+W	Close current tab	Outside Claude Code
Cmd+Option+Right	Next tab	Outside Claude Code

Linux-Specific Shortcuts

Shortcut	Action	Notes
Alt+Tab	Switch windows	System-level, not Claude Code specific
Ctrl+Alt+T	Open terminal	Varies by desktop environment

Windows PowerShell Shortcuts

Shortcut	Action	Notes
Ctrl+L	Clear screen	Clears terminal view
Ctrl+A	Select all	In text input
Ctrl+C	Copy	Copies selected text
Ctrl+V	Paste	Pastes text

tmux Navigation (Split Panes)

If using tmux for split panes:

Shortcut	Action	Notes
Ctrl+B then Up/Down/Left/Right	Navigate panes	Move between teammate panes
Ctrl+B then Z	Zoom pane	Fullscreen current pane
Ctrl+B then Exit zoom	Unzoom	Return from fullscreen
Ctrl+B then !	Break pane	Move pane to new window
Ctrl+B then X	Kill pane	Close specific pane
Ctrl+B then D	Detach session	Exit while keeping running

iTerm2-Specific (Mac)

Shortcut	Action	Notes
Cmd+Option+I	Split pane vertically	iTerm2 built-in
Cmd+]	Next split	Navigate iTerm2 splits
Cmd+[	Previous split	Navigate iTerm2 splits
Cmd+Option+H	Split pane horizontally	iTerm2 built-in

Common Workflows

Review Code with Team

1. Shift+Down to find security reviewer
2. Enter to see their findings
3. Escape to return to lead view
4. Shift+Down to check performance reviewer
5. Ctrl+T to see task status

Debug with Hypotheses Team

1. Shift+Down through 5 teammates checking each investigation
2. Enter on slowest to ask for more detail
3. Escape back to lead
4. Ctrl+T to check if tasks complete
5. Shift+Tab to enable delegate mode for synthesis

Monitor Large Team (Split Panes)

1. Claude starts with split panes ready
2. Click different panes to monitor
3. Click into pane to send message
4. Click teammate column to focus

Useful Terminal Commands (Outside Claude Code)

# List all team directories
ls ~/.claude/teams/

# List tasks for specific team
ls ~/.claude/tasks/team-name/

# View team config
cat ~/.claude/teams/team-name/config.json

# Kill orphaned tmux session
tmux kill-session -t session-name

# List all tmux sessions
tmux ls

# Restart Claude Code
pkill -f "claude"
claude

Cheat Sheet

Quick Team Check (In-Process)

Shift+Down → Shift+Down → Shift+Down → Shift+Tab (enable delegate)
(Cycle through team, then enable delegate mode for synthesis)

Full Review Cycle

Shift+Down (Find reviewer 1)
Enter (See their findings)
Escape (Return to lead)
Shift+Down (Find reviewer 2)
Enter (See their findings)
Escape (Return to lead)
Ctrl+T (View task list)

Delegate Mode Workflow

Shift+Tab (Enable)
Ctrl+T (View tasks)
(Coordinate)
Shift+Tab (Disable if needed)

Accessibility Tips

• No mouse? Use keyboard for everything - all tmux navigation available via keyboard
• Small screen? Use in-process mode and Shift+Up/Down instead of split panes
• Large team? Split panes with multiple monitors for visibility
• Remote? SSH into terminal, use in-process mode (more reliable)

Customization

Remap Shortcuts in Your Shell

.bashrc or .zshrc:

# Quick start for Claude Code with teams
alias ct='claude'

# Kill orphaned sessions
alias cleanup-teams='tmux kill-session -t claude || true'

Terminal Configuration

Most modern terminals support:

• Shift+Up/Down for history (conflicts with Claude Code teammate nav)
• Ctrl+T for new tab (conflicts with Claude Code task list)

These generally work as Claude Code has priority in its own sessions.

Troubleshooting Shortcuts

Q: Shift+Down not working A:

1. May be terminal-level shortcut
2. Check terminal settings
3. Try in-process mode with different terminal

Q: Ctrl+T not showing task list A:

1. Make sure in lead session (not teammate)
2. Try again after waiting for page render
3. Try typing "Show me the task list" instead

Q: Enter not entering teammate session A:

1. May need to be in in-process mode
2. Verify teammate exists (Shift+Down shows them)
3. Try messaging instead with "Tell teammate..."

Q: Split panes shortcuts not working A:

1. Check tmux is running: tmux ls
2. Try with explicit prefix: Ctrl+B then Arrow
3. May need to enable iTerm2 Python API

See Also

• Commands Reference
• SOP-003: Configure Display Modes
• Architecture