Goal
Master NTM (Named Tmux Manager) for orchestrating agents.
What Is NTM?
NTM is your command center for managing multiple coding agents.
It creates organized tmux sessions with dedicated panes for each agent.
$ntm spawn myproject --cc=2 --cod=1 --gmi=1
Claude-1
Claude-2
Codex
Gemini
The NTM Tutorial
NTM has a built-in tutorial. Start it now:
bash
ntm tutorial
This will walk you through the basics interactively.
Essential NTM Commands
Check Dependencies
bash
ntm deps -v
Verifies all required tools are installed.
Create a Project Session
bash
ntm spawn myproject --cc=2 --cod=1 --gmi=1
Creates a tmux session with multiple agent panes.
2 Claude Code panes
1 Codex pane
1 Gemini pane
Session: "myproject"
List Sessions
bash
ntm list
See all running NTM sessions.
Attach to a Session
bash
ntm attach myproject
Jump into an existing session to see agent output.
Send a Command to All Agents
bash
ntm send myproject "Analyze this codebase and summarize what it does"
This sends the same prompt to ALL agents in the session!
Warning
If ntm send fails with a CASS error (for example: “unrecognized subcommand 'robot'”), bypass duplicate-checking:
bash
ntm send myproject --no-cass-check "Analyze this codebase and summarize what it does"
bash
ntm --robot-send myproject --msg "Analyze this codebase and summarize what it does" --all
Send to Specific Agent Type
bash
ntm send myproject --cc "Focus on the API layer"ntm send myproject --cod "Focus on the frontend"
Target specific agent types with different tasks.
The Power of NTM
Imagine this workflow:
1
Spawn a session with multiple agents2
Send a high-level task to all of them3
Each agent works in parallel4
Compare their solutions5
Take the best parts from eachNote
That's the power of multi-agent development—different perspectives working in parallel!
Quick Session Template
For a typical project:
bash
ntm spawn myproject --cc=2 --cod=1 --gmi=1
Why this ratio?
2
Claude - Great for architecture and complex reasoning
1
Codex - Fast iteration and testing
1
Gemini - Different perspective, good for docs
Session Navigation
Once inside an NTM session:
Keys
Action
Ctrl+athenn
Next window
Ctrl+athenp
Previous window
Ctrl+athenh/j/k/l
Move between panes
Ctrl+athenz
Zoom current pane
Try It Now
bash
1# Create a test session2$ ntm spawn test-session --cc=134# List sessions5$ ntm list67# Send a simple task8$ ntm send test-session "Say hello and confirm you're working"910# Attach to see the result11$ ntm attach test-session