libtmux MCP server
Commit 12. Nov. 2026Ermöglicht es AI Agents, tmux Sessions, Windows und Panes zu verwalten, indem sie Commands ausführen, Terminal-Output lesen und Terminal-Umgebungen orchestrieren.
Auch bekannt als tmux-python/libtmux-mcp
- Stars
- 14
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 12. Nov. 2026
- Lizenz
- MIT
Was ist libtmux MCP?
Ermöglicht es AI Agents, tmux Sessions, Windows und Panes zu verwalten, indem sie Commands ausführen, Terminal-Output lesen und Terminal-Umgebungen orchestrieren.
Zusammenfassung generiert aus dem README des Projekts
Über libtmux MCP server
libtmux-mcp ermöglicht es, Terminal-Umgebungen und langlaufende Prozesse direkt aus einem AI Agent heraus zu verwalten. Dieser MCP server schlägt eine Brücke zwischen Model Context Protocol Clients und tmux, sodass Agents Sessions erstellen, Windows verwalten und einzelne Panes steuern können. Er wurde für Entwickler konzipiert, die Tools wie Claude Desktop, Claude Code, Codex CLI oder Gemini CLI nutzen und ihren KI-Assistenten eine direkte Interaktion mit einer Terminal-Umgebung geben möchten.
User können den Server lokal über uvx einrichten oder ihn ihrer Client-Config hinzufügen. Der Server enthält spezialisierte Tools für eine anspruchsvolle Terminal-Orchestrierung, wie zum Beispiel run_command zum Ausführen von Shell-Commands inklusive Exit-Status, wait_for_text zum Überwachen von Output ohne ständiges Polling und capture_since, um nur neue Terminal-Zeilen zu lesen. Zudem bietet er Pane-Management durch Tools wie split_window, resize_pane und send_keys_batch für die Interaktion mit textbasierten User Interfaces.
Diese Implementierung legt den Fokus auf Effizienz und Sicherheit. Sie nutzt History Suppression, um Agent-Commands aus der Shell-History fernzuhalten, und enthält Schutzmechanismen, um zu verhindern, dass ein Agent versehentlich seine eigene Host-Session killt. Entwickler können die Fähigkeiten des Agents weiter verfeinern, indem sie die Umgebungsvariable LIBTMUX_TOOLSETS nutzen, um spezifische Tool-Gruppen wie inspect, manage, execute oder teardown ein- oder auszuschließen.
Was du damit machen kannst
- 1Automatisierte TestausführungBitte einen Agent darum, eine neue tmux Session zu starten und eine spezifische Test-Suite auszuführen, während die Ergebnisse überwacht werden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbartmux-python/libtmux-mcp is public and reachablegithub.com/tmux-python/libtmux-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-12github.com/tmux-python/libtmux-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenlibtmux-mcp
A Model Context Protocol server for tmux, built on libtmux.
[!WARNING] Alpha. Releases carry an
-alphaprerelease tag. The API is not settled, and any release may change or remove exported identifiers without a deprecation period. Pin an exact version. Not recommended for production.
Give your AI agent hands inside the terminal — create sessions, run commands, read output, orchestrate panes.
Tools
| Module | Tools |
|---|---|
| Server | list_servers, list_sessions, create_session, kill_server, get_server_info |
| Batch | call_read_tools_batch |
| Session | list_windows, get_session_info, create_window, rename_session, select_window, kill_session |
| Window | list_panes, get_window_info, split_window, rename_window, select_layout, resize_window, move_window, kill_window |
| Pane | run_command, send_keys, send_keys_batch, paste_text, capture_pane, capture_since, snapshot_pane, search_panes, find_pane_by_position, get_pane_info, wait_for_text, wait_for_channel, signal_channel, display_message, select_pane, swap_pane, resize_pane, set_pane_title, clear_pane, pipe_pane, enter_copy_mode, exit_copy_mode, respawn_pane, kill_pane |
| Options | show_option, set_option |
| Environment | show_environment, set_environment |
| Buffers | load_buffer, paste_buffer, show_buffer, delete_buffer |
| Hooks | show_hooks, show_hook |
Quickstart
Requirements: Python 3.11+, tmux >= 3.2a on $PATH.
The distribution is libtmux-mcp, the import is libtmux_mcp, and the
installed executable is libtmux-mcp.
Install and run:
$ uvx libtmux-mcp
Claude Code
$ claude mcp add tmux -- uvx libtmux-mcp
Codex CLI
$ codex mcp add tmux -- uvx libtmux-mcp
Gemini CLI
$ gemini mcp add tmux uvx -- libtmux-mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"tmux": {
"command": "uvx",
"args": ["libtmux-mcp"]
}
}
}
More clients and JSON config: client setup docs
What it feels like
You: Create a session called "api" and run
pytest tests/api/ -xin it.Agent: Created session
apiwith windowtests. Running pytest now. Here's the output — 14 passed, 2 failed. The failures are intest_auth.py::test_token_refreshandtest_auth.py::test_expired_session. Want me to open those files?
The agent manages tmux directly. No copy-pasting terminal output. No switching windows to check on long-running processes.
When the server earns its keep
For a single tmux send-keys, the server doesn't. It earns its keep
the moment the agent has to wait, inspect, or avoid damaging the
terminal it is using — pytest finishing, a dev server printing its
port, a deploy log settling. The difference then is not more access
to tmux, but a better place to put the control loop.
The server-side moves are:
Running. run_command
sends an authored shell command, waits for deterministic completion,
and returns exit status plus tail-preserved output as one typed value.
The command and its completion signal reach the shell as one
space-prefixed event, so best-effort
history suppression
keeps agent-generated input out of shell history by default. The
alternative — hand-rolled send-keys plus wait-for plus a pane
capture — leaves every typed command, signal included, in shell
history.
Driving. send_keys_batch
sends several ordered raw-input operations for TUIs and persistent
shell interaction. It is deliberately not a workflow DSL; command
completion stays in run_command, and repeated observation stays in
capture_since.
Waiting. wait_for_text
blocks inside the server until a condition fires for output the agent
does not author. The alternative is the model polling capture-pane
in a loop, paying both context tokens and round-trip latency for every
turn.
Reading. snapshot_pane
returns content, cursor, copy-mode state, and scroll offset as one
typed value. The alternative is several tmux invocations stitched
together with regex.
Observing. capture_since
returns a cursor with the current pane content, then returns only
newly written or rewritten rows on follow-up calls. The alternative is
re-sending the same scrollback to the model on every check.
Guarding. The server detects the agent's own pane across sockets
and declines to end its own — kill_session
on itself fails loudly instead of silently terminating the host
environment the agent is running in. LIBTMUX_TOOLSETS
(inspect, manage, execute, teardown) drops whole toolsets from the
client's tool list before any prompt is built. The sets are unordered, so
inspect,teardown is a legal surface. Dropping one is inventory and MCP
tool-call configuration, not containment: an enabled execute tool can type
the equivalent of anything it hides.
Documentation
Full docs, guides, and tool reference: libtmux-mcp.git-pull.com
Development
Clone and install:
$ git clone https://github.com/tmux-python/libtmux-mcp.git
$ cd libtmux-mcp
$ uv sync --all-extras --dev
Run the server locally:
$ uv run libtmux-mcp
Run tests:
$ uv run pytest
See CONTRIBUTING.md for the gates, and WRITING.md for how this project writes prose, docstrings, and MCP tool descriptions.
Related projects
- libtmux — Python API for tmux
- tmuxp — tmux session manager
- The Tao of tmux — the book
Attribution
Please use the following BibTeX template to cite libtmux-mcp in scientific discourse:
@misc{libtmux-mcp,
author = {Tony Narlock},
year = {2026},
note = {https://libtmux-mcp.git-pull.com},
title = {libtmux-mcp: MCP server for tmux}
}
License
MIT
libtmux MCP Fragen
Ist dieser Server bereit für den Produktivbetrieb?
Nein, der Server befindet sich aktuell in der Alpha-Phase. Das bedeutet, dass die API noch nicht final festgelegt ist und Releases sich ändern oder Identifikatoren ohne Vorankündigung entfernen können.
Kann der Agent Commands ausführen, ohne die Shell-History zu überladen?
Ja, das run_command Tool nutzt History Suppression, um sicherzustellen, dass vom Agent generierte Inputs standardmäßig nicht in der Shell-History landen.