tmai

Tactful Multi Agent Interface — Monitor and control multiple AI coding agents from a unified WebUI.

Features

WebUI Dashboard (Default)

• Multi-agent monitoring — Track Claude Code, OpenCode, Codex CLI, Gemini CLI in real-time
• Interactive terminal — Full xterm.js terminal with WebGL rendering and WebSocket I/O
• Branch graph — GitKraken-style lane-based commit graph with branch hierarchy
• GitHub integration — PR status, CI checks, issues with branch-to-issue linking
• Worktree management — Create, delete, diff, and launch agents in Git worktrees
• Markdown viewer — Browse and edit project documentation in-app
• Security panel — Scan Claude Code settings and MCP configs for vulnerabilities
• Usage tracking — Monitor token consumption for Claude Max/Pro subscriptions
• Agent spawn — Launch new agents directly from the UI (PTY or tmux window)
• Auto-approve — Automatic approval with 4 modes: Rules / AI / Hybrid / Off
• Agent Teams — Visualize Claude Code Agent Teams and task progress
• Inter-agent messaging — Send text between agents
• Cursor tracking — Terminal cursor overlay in preview (tmux + IPC/VT100, CJK-aware)

3-Tier State Detection

• HTTP Hooks (recommended) — Event-driven, highest precision, zero latency
• IPC (PTY wrap) — Direct I/O monitoring via Unix domain socket
• capture-pane (fallback) — tmux screen text analysis, no setup required

Additional Modes

• TUI mode (--tmux) — ratatui terminal UI for tmux power users
• Mobile remote — Approve from your smartphone via QR code
• Demo mode (demo) — Try without tmux or agents

Installation

cargo install tmai

Quick Start

# Set up hooks for high-precision detection (one-time)
tmai init

# Launch WebUI (opens Chrome App Mode automatically)
tmai

The WebUI opens at http://localhost:9876 with token-based authentication.

TUI Mode (Optional)

# Run in tmux TUI mode (requires tmux)
tmai --tmux

Documentation

Detailed guides, configuration reference, and workflows are available in doc/.

Supported Agents

Screenshots

WebUI Dashboard

Branch Graph

Mobile Remote

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT