Serveur MCP libtmux
Commit 12 nov. 2026Permet aux agents IA de gérer des sessions, des fenêtres et des volets tmux en exécutant des commandes, en lisant la sortie du terminal et en orchestrant des environnements terminaux.
Aussi connu sous tmux-python/libtmux-mcp
- Étoiles
- 14
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 12 nov. 2026
- Licence
- MIT
Qu'est-ce que libtmux MCP ?
Permet aux agents IA de gérer des sessions, des fenêtres et des volets tmux en exécutant des commandes, en lisant la sortie du terminal et en orchestrant des environnements terminaux.
Résumé généré à partir du README du projet
À propos du MCP server libtmux
libtmux-mcp permet de gérer des environnements terminaux et des processus de longue durée directement depuis un agent IA. Ce serveur sert de pont entre les clients Model Context Protocol et tmux, permettant aux agents de créer des sessions, de gérer des fenêtres et de contrôler des volets individuels. Il est conçu pour les développeurs utilisant des outils tels que Claude Desktop, Claude Code, Codex CLI ou Gemini CLI afin d'offrir à leurs assistants IA une interaction directe avec un environnement terminal.
Les utilisateurs peuvent installer le serveur localement via uvx ou en l'ajoutant à la configuration de leur client. Le serveur inclut des outils spécialisés pour une orchestration terminale sophistiquée, comme run_command pour exécuter des commandes shell avec le code de sortie, wait_for_text pour surveiller la sortie sans interrogation constante, et capture_since pour ne lire que les nouvelles lignes du terminal. Il propose également la gestion des volets via des outils comme split_window, resize_pane et send_keys_batch pour interagir avec des interfaces utilisateur textuelles.
Cette implémentation privilégie l'efficacité et la sécurité. Elle utilise la suppression d'historique pour éviter que les commandes de l'agent ne polluent l'historique du shell et inclut des garde-fous pour empêcher un agent de tuer accidentellement sa propre session hôte. Les développeurs peuvent affiner les capacités de l'agent en utilisant la variable d'environnement LIBTMUX_TOOLSETS pour inclure ou exclure des groupes d'outils spécifiques tels que inspect, manage, execute ou teardown.
Ce que vous pouvez faire avec
- 1Exécution automatisée de testsDemandez à un agent de démarrer une nouvelle session tmux et d'exécuter une suite de tests spécifique tout en surveillant les résultats.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibletmux-python/libtmux-mcp is public and reachablegithub.com/tmux-python/libtmux-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-12github.com/tmux-python/libtmux-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHublibtmux-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
Questions sur libtmux MCP
Ce serveur est-il prêt pour une utilisation en production ?
Non, le serveur est actuellement en version Alpha, ce qui signifie que l'API n'est pas encore stabilisée et que les versions peuvent changer ou supprimer des identifiants sans préavis.
L'agent peut-il exécuter des commandes sans encombrer l'historique du shell ?
Oui, l'outil run_command utilise la suppression d'historique pour que les entrées générées par l'agent ne figurent pas dans l'historique du shell par défaut.