howardpen9

Tmux Bridge MCP — AI skill for Claude Code

AI community

Standalone MCP server for cross-pane AI agent communication via tmux.

How to install Tmux Bridge MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open howardpen9/tmux-bridge-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tmux Bridge MCP does

Standalone MCP server for cross-pane AI agent communication via tmux. Lets Claude Code, Gemini CLI, Codex, and Kimi CLI talk to each other through tmux panes.

Alternatives in AI

Hexstrike AI — HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomousl 8.2k ★
ARIS Agent Guide — For AI agents reading this repo 6.2k ★
Peekaboo — Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, o 3.2k ★

README

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 Claude to review a file
Coordinate multi-agent workflows	Chain tool calls	Gemini researches -> Claude implements -> Codex reviews
Monitor processes	`tmux_read` on a shell pane	Watch build logs, test output, server status