tmai
Tmux Multi Agent Interface - Monitor and control multiple AI agents running in tmux.
Features
- Multi-agent monitoring - Track Claude Code, OpenCode, Codex CLI, Gemini CLI across tmux panes
- Single-pane operation - Approve, respond, and interact without switching panes
- Real-time preview - See agent output with ANSI color support
- 3-tier state detection - Hooks (HTTP) > IPC (PTY wrap) > capture-pane, automatic fallback
- Web remote control - Control agents from your smartphone via QR code
- Agent Teams - Visualize Claude Code Agent Teams and task progress
- Auto-approve - Automatic approval with 4 modes: Rules / AI / Hybrid / Off
- Fresh Session Review - Automatic context-free code review on agent completion
- Security monitoring - Exfil detection for external data transmission
Installation
Quick Start
# Set up hooks for high-precision detection (one-time)
# Run tmai in a tmux session
Keybindings
| Key | Action |
|---|---|
j / k |
Navigate agents |
y |
Approve / Yes |
n |
No |
1-9 |
Select option |
i |
Input mode |
-> |
Passthrough mode |
R |
Launch code review |
U |
Subscription usage |
? |
Help |
Documentation
Detailed guides, configuration reference, and workflows are available in doc/.
| Category | Links |
|---|---|
| Getting Started | Installation & First Steps |
| Features | Hooks - Auto-Approve - Agent Teams - Web Remote - PTY Wrapping - Fresh Session Review |
| Workflows | Multi-agent - Worktree Parallel - Remote Approval |
| Reference | Config - Keybindings - Web API |
Supported Agents
| Agent | Detection | Hooks | PTY Wrap |
|---|---|---|---|
| Claude Code | Yes | Yes | Yes |
| OpenCode | Yes | - | Yes |
| Codex CLI | Yes | - | Yes |
| Gemini CLI | Yes | - | Yes |
Web Remote
Acknowledgments
Inspired by tmuxcc.
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT