libtmux-mcp server
oficialServidor MCP de tmux impulsado por libtmux
¿Qué puedes hacer con Libtmux MCP?
- Inspeccionar el estado de tmux — Solicitar listar sesiones, capturar la salida de un panel o buscar texto específico en los paneles.
- Gestionar la estructura de tmux — Renombrar sesiones, redimensionar paneles, seleccionar diseños o mover ventanas entre sesiones.
- Ejecutar comandos en paneles — Crear sesiones/ventanas, dividir paneles, enviar pulsaciones de teclas o ejecutar comandos de shell.
- Controlar procesos de paneles — Pegar texto o búferes, canalizar la salida de paneles o establecer variables de entorno y opciones.
- Eliminar objetos de tmux — Limpiar el historial de desplazamiento de paneles, cerrar sesiones/ventanas/paneles o eliminar búferes.
- Suprimir el historial de shell — Crear sesiones o ventanas con controles de historial sin disco para ejecuciones de pruebas más limpias.
Documentación
Control de terminal para agentes de IA, construido sobre libtmux y FastMCP.
Este servidor mapea la jerarquía de objetos de tmux — sesiones, ventanas, paneles — en herramientas MCP agrupadas por la operación que solicitan. El servidor aplica los grupos seleccionados en el límite de las herramientas MCP.
[!warning] Advertencia Pre-alfa. Las APIs pueden cambiar. Comentarios bienvenidos.
Con uvx instalado:
$ claude mcp add tmux -- uvx libtmux-mcp
Inicio rápido
Herramientas
Prompts
Recursos
Modelo de confianza
Configuración del cliente
Lo que puedes hacer
Inspeccionar inspeccionar
Solicita el estado de tmux y la salida del 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
Gestionar gestionar
Cambia la estructura o presentación de tmux.
rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel
Ejecutar ejecutar
Inicia o controla procesos de paneles, o almacena estado que puede controlar ejecuciones posteriores.
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
Desmontar desmontar
Elimina objetos de tmux o el scrollback retenido. No reversible.
clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer
Ejemplo: mantener ejecuciones de pruebas fuera del historial persistente
libtmux-mcp proporciona supresión de historial de mejor esfuerzo para Bash, Zsh y Fish. Las llamadas MCP a run_command usan supresión ligera de comandos por defecto. Cuando creas un nuevo shell, opta por controles más fuertes sin escritura en disco con suppress_persistent_history=true.
[!note] Prompt Crea una sesión de tmux llamada "checks" con controles de historial de shell de mejor esfuerzo sin escritura en disco, ejecuta
pytest -qen su panel inicial, y muéstrame el resultado.
El agente llama a create_session con suppress_persistent_history=true, reutiliza active_pane_id del SessionInfo devuelto, y llama a run_command sin una anulación. La misma opción de spawn en create_window, split_window, o respawn_pane se aplica solo al proceso que esa llamada inicia.
Estos controles reducen el ruido del historial; no hacen que los comandos sean secretos. Consulta Supresión de historial para el comportamiento específico de cada shell, Configuración para el valor predeterminado del servidor, y Modelo de confianza para otras superficies de observación.
Explorar todas las herramientas →
Modelo mental
- Jerarquía de objetos — las sesiones contienen ventanas, las ventanas contienen paneles (Conceptos)
- Conjuntos de herramientas — inspeccionar, gestionar, ejecutar, desmontar; qué agrupa cada uno (Modelo de confianza)
- tmux es la fuente de verdad — el servidor lee de él y escribe en él, nunca almacena en caché ni abstrae