libtmux-mcp server

officiel

Serveur MCP tmux propulsé par libtmux

Voir sur git-pull.comEssayer ce MCPSponsorisé

Que pouvez-vous faire avec Libtmux MCP ?

Inspecter l’état de tmux — Demander de lister les sessions, capturer la sortie d’un volet, ou rechercher du texte dans les volets.
Gérer la structure de tmux — Renommer les sessions, redimensionner les volets, sélectionner les mises en page, ou déplacer les fenêtres entre les sessions.
Exécuter des commandes dans les volets — Créer des sessions/fenêtres, diviser les volets, envoyer des frappes clavier, ou exécuter des commandes shell.
Contrôler les processus des volets — Coller du texte ou des tampons, rediriger la sortie des volets, ou définir des variables d’environnement et des options.
Détruire les objets tmux — Effacer le défilement des volets, tuer les sessions/fenêtres/volets, ou supprimer les tampons.
Supprimer l’historique du shell — Créer des sessions ou des fenêtres avec des contrôles d’historique sans disque pour des exécutions de tests plus propres.

Documentation

Contrôle de terminal pour agents IA, construit sur libtmux et FastMCP.

Ce serveur mappe la hiérarchie d’objets de tmux — sessions, fenêtres, panneaux — en outils MCP regroupés par l’opération qu’ils demandent. Le serveur applique les groupes sélectionnés à la frontière des outils MCP.

[!warning] Avertissement Pré-alpha. Les API peuvent changer. Retours bienvenus.

Avec uvx installé :

$ claude mcp add tmux -- uvx libtmux-mcp

Démarrage rapide

Outils

Invites

Ressources

Modèle de confiance

Configuration client

Clients MCP

Ce que vous pouvez faire

Inspecter inspecter

Demander l’état de tmux et la sortie du terminal.

list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · display_message · call_read_tools_batch

Gérer gérer

Modifier la structure ou la présentation de tmux.

rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel

Exécuter exécuter

Démarrer ou piloter des processus de panneau, ou stocker un état pouvant contrôler une exécution ultérieure.

create_session · create_window · split_window · respawn_pane · send_keys · send_keys_batch · run_command · paste_text · paste_buffer · pipe_pane · set_option · set_environment

Démanteler démanteler

Supprimer des objets tmux ou le défilement conservé. Non réversible.

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

Exemple : garder les exécutions de tests hors de l’historique persistant

libtmux-mcp fournit une suppression d’historique au mieux pour Bash, Zsh et Fish. Les appels MCP à run_command utilisent une suppression de commande légère par défaut. Lorsque vous créez un nouveau shell, optez pour des contrôles sans disque plus stricts avec suppress_persistent_history=true.

[!note] Invite Créez une session tmux nommée « checks » avec des contrôles d’historique shell sans disque au mieux, exécutez pytest -q dans son panneau initial, et montrez-moi le résultat.

L’agent appelle create_session avec suppress_persistent_history=true, réutilise active_pane_id depuis le SessionInfo retourné, et appelle run_command sans remplacement. La même option de lancement sur create_window, split_window ou respawn_pane s’applique uniquement au processus que cet appel démarre.

Ces contrôles réduisent le bruit d’historique ; ils ne rendent pas les commandes secrètes. Voir Suppression d’historique pour le comportement spécifique au shell, Configuration pour la valeur par défaut du serveur, et Modèle de confiance pour les autres surfaces d’observation.

Parcourir tous les outils →

Modèle mental

Hiérarchie d’objets — les sessions contiennent des fenêtres, les fenêtres contiennent des panneaux (Concepts)
Ensembles d’outils — inspecter, gérer, exécuter, démanteler ; ce que chacun regroupe (Modèle de confiance)
tmux est la source de vérité — le serveur lit depuis et écrit vers tmux, ne met jamais en cache ni n’abstrait