Skip to content
ChrAlpha edited this page Nov 12, 2026 · 6 revisions
🇬🇧English | 🇨🇳中文

tmux-agent-experience

A tmux plugin that knows what your coding agents are doing.

Keep Claude Code, Codex, Pi and oh-my-pi in your usual panes. See who is working, waiting or done—and let agents discover each other, send work and read replies. tmux stays tmux, agents stay agents; tmag is only the thread between them.

Start here

  1. Install tmag and connect your agents.
  2. Press prefix + a to see them, or prefix + A to jump to one waiting.
  3. Ask an agent to involve another when you want them to collaborate.

Guides and reference

Guide What you will find
Installation & Updates Install, connect agents, update and uninstall.
tmux Integration Keys, bells, status formats and options.
Agent Collaboration Ask agents to work together and exchange replies.
CLI Reference List, send, read, wait, interrupt and answer.
HTTP API Serve local state and controls to authorized clients.
Notifications Connect alerts to your notification command.
Troubleshooting Diagnostics, compatibility and known limitations.
Architecture & Contracts Design guarantees, JSON/events and storage.

Project

Repository · Releases · Contributing · Security

Clone this wiki locally