tmux-bridge-mcp
An MCP server that lets agents in neighboring tmux panes read each other, hand off tasks and watch logs, no framework.
- 108 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- An agent types text and keys into other terminal panes and so can run a command in another shell.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/tmux-bridge-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- An agent types text and keys into other terminal panes and so can run a command in another shell.
This is third-party code. Review the repository files before installing.
What it does
tmux-bridge-mcp connects agents running in different tmux panes: Claude Code, Codex, Gemini CLI, Kimi CLI, OpenCode, CodeBuddy, Copilot CLI and Grok Build. The server runs over `stdio` and talks to tmux directly through `capture-pane`, `send-keys` and `list-panes`, with no intermediate layer. An agent reads another pane output (`tmux_read`), sends a message or command (`tmux_message`, `tmux_type`, `tmux_keys`), names panes by role (`tmux_name`) and finds the one it needs by label. The flow is read, write, read again to confirm the text landed. This way Gemini researches, Claude writes code and Codex reviews without copying through the clipboard.
Who it is for. Developers running several AI agents in one tmux who are tired of carrying context between them by hand.
Good fit when
- Claude finished a function and Codex in the next pane should review it.
- An agent watches a `tail -f` pane and reacts to build errors.
- A Gemini researcher hands findings to the implementer by pane label.
- A chain of three agents is wanted without rewriting for CrewAI or LangChain.
Not a fit when
- The agents run outside tmux, in separate windows or on other machines.
- A protocol for networked distributed agents is required.
- An agent must not be able to drive input in other terminals.
Example request
Read the last 20 lines of the codex pane, send it a request to review my file and read again to see the result.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
tmux 3.2 or newer and Node.js 18 or newer are required. The server types text and keystrokes into other panes, so an agent can send a command to a shell: isolate panes holding important sessions. The read-before-write guard requires reading a pane before writing but does not replace human confirmation. Kimi CLI uses a separate adapter instead of MCP. Agents must be restarted after setup, and under `npx` the version is cached, so updating needs `npx tmux-bridge-mcp@latest`.
How to disable. Remove the `tmux-bridge` entry from each agent MCP config and, if installed globally, run `npm uninstall -g tmux-bridge-mcp`.
FAQ
How do I set up every agent at once?
With `npx tmux-bridge-mcp setup`: it detects installed agents and writes the right MCP config for each.
How many tools does the server have?
Nine, including `tmux_read`, `tmux_message`, `tmux_type`, `tmux_keys`, `tmux_name`, `tmux_list`, `tmux_resolve`, `tmux_id` and `tmux_doctor`.
Can I configure it manually?
Yes. Add a `tmux-bridge` server to the agent config with the `npx` command and the arguments `-y tmux-bridge-mcp`.
Is a separate protocol between agents needed?
No. Everything goes through regular MCP tool calls and tmux itself is the transport.
Is the README translated?
Yes, into Chinese: `README.zh-CN.md`.
Discussion
No questions or reviews yet.
Related
MCP serversA tuned tmux setup and the tmux-bridge CLI that lets agents read neighbouring panes, type into them and hand each other tasks.
ccmux tracks every coding agent in tmux: who is working, who waits for you, worktree spawning and answer hand-off.
A CLI and terminal app that show which coding agents in your tmux sessions are working, waiting on you or done
A tmux-based TUI that runs Claude Code, Codex and other agents in one list: status, quick prompts, worktrees and diff review
ReevesAgents runs Claude Code, Codex, Hermes and other CLI agents side by side in tmux; an MCP lets one lead the rest.
A terminal workspace where several CLI agents like Codex, Claude and Gemini exchange messages and work on one task under human oversight
README in short
The README explains what tmux is, the problem the bridge solves, supported agents, quick start, updating and the architecture with a read, act, read order.