# tmux

tmux is an MCP server for Claude Code that controls sessions, windows, and panes on one tmux server. An agent can run commands in a pane and wait for matching text.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: libtmux
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/libtmux/libtmux-go/tree/HEAD/mcp
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tmux

## What it does

The server connects an MCP client to a single tmux server and exposes its sessions, windows, and panes to an agent. The agent can split a pane, send text to it, run a command, then wait for a pattern to appear.

Socket selection happens at startup through flags or environment variables. Toolsets include `inspect`, `manage`, and `execute`, but choosing a toolset does not restrict the process's user permissions. It requires Go 1.26 or newer and tmux 3.3a or newer on `PATH`.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- manage tmux sessions through an MCP client
- open a separate pane for an agent task
- send a command to a pane and read its output
- wait for a text pattern to appear in a pane

## Example prompts
- Create a tmux session named `demo` and list its panes.
- Split the current pane to the right and run `go test ./...` in the new one.
- Wait until `ready` appears in pane `%1` and report the result.

## Similar
- [using-tmux-for-interactive-commands](https://affpapa.org/en/nevibecode/skills/using-tmux-for-interactive-commands.md) — skill · 515 installs
- [tmux-skill](https://affpapa.org/en/nevibecode/skills/tmux-skill.md) — skill · 226 installs
- [tmux-terminal](https://affpapa.org/en/nevibecode/skills/tmux-terminal.md) — skill · ★ 3206 repo stars
- [tmux-cli](https://affpapa.org/en/nevibecode/skills/tmux-cli.md) — skill · ★ 2039 repo stars
- [tmux-fleet](https://affpapa.org/en/nevibecode/skills/tmux-fleet.md) — skill · ★ 62 repo stars
- [tmux-status](https://affpapa.org/en/nevibecode/plugins/tmux-status.md) — plugin · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
