tmux
MCP server that lets AI clients drive tmux sessions, windows, and panes
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Version
- 0.0.1-alpha.5
- Listing updated
- today
Similar MCP servers
About tmux
tmux is an open-source MCP server for developer tools. It is available on CLI, Linux, macOS and self-hosted.
The README says this Go server gives Model Context Protocol clients control over one tmux server, covering its sessions, windows, panes, and the output those panes produce. Clients are launched as a subprocess over stdin and stdout, and tmux sessions keep running after the client closes.
Tools are grouped into toolsets (inspect, manage, execute, teardown). By default inspect, manage and execute are granted, while teardown must be requested by name. Waiting for text in a pane, running a shell command and reading its exit status, and splitting panes are among the calls the README demonstrates.
It suits developers who want an AI agent to run long-lived work such as dev servers or test runs in a terminal and watch the output. Operators can narrow what a client may do with environment variables, and input to a pane a person is viewing is refused unless explicitly allowed. The README notes that toolsets shape what is offered but every call runs with the user's own authority.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- split_window
- Adds a pane and returns its id.
- wait_for_text
- Returns when a pattern appears in a pane or a stop pattern matches.
- run_shell_command
- Waits for a command and returns its exit status and output.
- capture_since
- Returns what a pane wrote since the last look.
- snapshot_pane
- Returns a pane's metadata and content together.
- send_keys
- Sends keys to a pane.
- paste_text
- Pastes text into a pane.
- kill_session
- Kills a tmux session.
What it does
- Session and pane control
- Creates, lists, renames, resizes and moves tmux sessions, windows and panes.
- Wait for pane output
- Blocks until a pattern appears in a pane or a stop pattern matches, with a configurable ceiling.
- Shell command execution
- Runs a command in a pane and returns its exit status and output.
- Toolset-based permissions
- Grants tools by toolset or exact name, with exclusions applied after inclusion.
- Protection for attended panes
- Refuses input to panes a tmux client is viewing unless explicitly allowed.
- Socket selection
- Targets a named or explicit tmux socket chosen once at server start.
Good for
- Run a dev server or test suite in a split pane and wait for it to report readiness
- Let an agent inspect tmux sessions and read pane output without sending input
- Drive long-running terminal work from an MCP client while keeping sessions alive after it closes
- Diagnose which tmux socket and binary a client reaches with the doctor command
Pricing
Open source
Open source; no paid plan mentioned in the README.
tmux FAQ
Which tmux version is required?
The README says Go 1.26 or newer and tmux 3.3a or newer, with some tools needing tmux 3.4 or 3.7.
Does closing the client stop tmux sessions?
No. The README says closing the client ends the server, but tmux sessions keep running.
Which toolsets are granted by default?
Without LIBTMUX_TOOLSETS the server grants inspect, manage and execute. The teardown toolset must be requested by name.
Can the server type into a pane I am watching?
Not by default. Input tools refuse a pane a tmux client is viewing unless LIBTMUX_ALLOW_ATTENDED_INPUT=1 is set.
Is tmux free?
Yes. tmux is open source, so you can use and self-host it for free.
What are the best alternatives to tmux?
The closest alternatives to tmux are shell-use, Coding Tools MCP, agent-manager.dev documentation, Unterm and McpMux.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.