tmai

Tmux Multi Agent Interface - Monitor and control multiple AI agents running in tmux.

Features

• Multi-agent monitoring - Track multiple AI coding agents (Claude Code, OpenCode, etc.) across tmux panes
• Single-pane operation - Approve without attaching to agent panes
• Real-time preview - See agent output without switching panes (with ANSI color support)
• Quick approval - Approve tool calls with single keystroke (y)
• AskUserQuestion support - Respond to agent questions with number selection
• Passthrough mode - Send keys directly to the agent pane
• Status detection - Automatic detection of idle, processing, and awaiting approval states
• PTY wrapping - High-precision state detection via PTY proxy for real-time I/O monitoring
• Exfil detection - Security monitoring for external data transmission
• Web Remote Control - Control agents from your smartphone via QR code
• Agent Teams - Visualize Claude Code Agent Teams structure and task progress
• Mode detection - Detect Plan/Delegate/Auto-approve modes from terminal title icons

Documentation

For detailed guides and workflows, see doc/:

• Getting Started - Installation and first steps
• Multi-agent Monitoring - Monitor multiple agents simultaneously
• Worktree Parallel Development - Git worktree workflow
• tmai's Strengths - What makes tmai unique
• Agent Teams - Claude Code team monitoring

Installation

cargo install tmai

Or build from source:

git clone https://github.com/trust-delta/tmai
cd tmai
cargo build --release

Usage

Run tmai in a tmux session:

tmai

Configuration

Create a config file in one of these locations (first found wins):

• ~/.config/tmai/config.toml
• ~/.tmai.toml

Example:

poll_interval_ms = 500
passthrough_poll_interval_ms = 10
capture_lines = 100
attached_only = true

[ui]
show_preview = true
preview_height = 40
color = true

[teams]
enabled = true
scan_interval = 5

Keybindings

Modes

• Normal mode - Navigate and quick actions
• Input mode (i) - Type text to send to agent
• Passthrough mode (→) - Keys sent directly to pane

PTY Wrapping

For more accurate state detection, you can wrap AI agents with a PTY proxy:

# Start Claude Code with PTY wrapping
tmai wrap claude

# With arguments
tmai wrap claude --dangerously-skip-permissions

# Other agents
tmai wrap codex
tmai wrap gemini

Benefits:

• Real-time I/O monitoring - Detects state changes immediately
• No polling delay - Faster than tmux capture-pane
• Accurate approval detection - Reliable Yes/No and AskUserQuestion detection

When creating new AI processes from tmai UI, they are automatically wrapped.

Web Remote Control

Control your AI agents from your smartphone:

1. Press r to display QR code
2. Scan with your phone
3. Approve or select options from the web interface

# config.toml
[web]
enabled = true
port = 9876

WSL2 Setup

For WSL2 with mirrored networking mode, allow the port through Windows Firewall:

# Run as Administrator
New-NetFirewallRule -DisplayName "tmai Web Remote" -Direction Inbound -Protocol TCP -LocalPort 9876 -Action Allow

For NAT mode (legacy), see CLAUDE.md for port forwarding setup.

Supported Agents

Screenshots

┌─────────────────┬─────────────────────────────────┐
│ Sessions        │ Preview                         │
│                 │                                 │
│ [IPC] main:0.0  │ Do you want to make this edit?  │
│   Claude Code   │                                 │
│   ⠋ Processing  │ ❯ 1. Yes                        │
│                 │   2. Yes, allow all...          │
│ [capture] 0.1   │   3. No                         │
│   Claude Code   │                                 │
│   ✳ Idle        │                                 │
└─────────────────┴─────────────────────────────────┘
 j/k:Nav 1-9:Select i:Input →:Direct ?:Help q:Quit

Acknowledgments

Inspired by tmuxcc.

License

MIT