tmux-bridge-mcp

# tmux-bridge-mcp

**English** | [简体中文](README.zh-CN.md)

![tmux-bridge-mcp](docs/images/hero-banner.png)

A standalone MCP server that lets AI agents (Claude Code, Gemini CLI, Codex, Kimi CLI) communicate with each other through tmux panes. It talks directly to tmux -- no external dependencies beyond tmux itself.

## 🖥️ What is tmux?

[tmux](https://github.com/tmux/tmux) is a **terminal multiplexer** -- it lets you split one terminal window into multiple **panes**, each running its own process independently. Think of it as "tabs on steroids" for your terminal.

![What is tmux](docs/images/what-is-tmux.png)

```
+-------------------------------+
|  Pane 1       |  Pane 2       |
|  Claude Code  |  Codex        |
|  writing code |  reviewing    |
|               |               |
+---------------+---------------+
|  Pane 3       |  Pane 4       |
|  Gemini CLI   |  tail -f logs |
|  researching  |  monitoring   |
+-------------------------------+
```

Each pane is a full terminal. You can have Claude Code running in one, Codex in another, Gemini in a third -- all visible at the same time, all on the same machine.

**The problem:** these panes can't talk to each other. An agent in Pane 1 has no idea what's happening in Pane 2.

![The Problem](docs/images/the-problem.png)

**tmux-bridge fixes this.** It gives every agent the ability to read, type, and send messages into any other pane.

![The Solution](docs/images/the-solution.png)

## ⚡ What can you do with tmux-bridge?

Once installed, your AI agents can:

| Action | How | Example |
|--------|-----|---------|
| **See what another agent is doing** | `tmux_read` | Read the last 20 lines of Codex's pane |
| **Send a task to another agent** | `tmux_message` + `tmux_keys` | Tell Gemini to review a file |
| **Coordinate multi-agent workflows** | Chain tool calls | Gemini researches -> Gemini implements -> Codex reviews |
| **Monitor processes** | `tmux_read` on a shell pane | Watch build logs, test output, server status |