libtmux-mcp server

oficial

Servidor MCP de tmux impulsado por libtmux

Ver en git-pull.com

¿Qué puedes hacer con Libtmux MCP?

  • Inspeccionar el estado de tmux — Leer detalles de sesiones, ventanas y paneles con list_sessions, capture_pane, get_pane_info o search_panes.
  • Enviar entrada a paneles — Escribir comandos o texto en un panel objetivo usando send_keys, send_keys_batch, run_command o paste_text.
  • Crear y organizar sesiones — Iniciar sesiones, ventanas y paneles divididos con nombre mediante create_session, create_window y split_window.
  • Destruir objetos de tmux — Eliminar sesiones, ventanas, paneles o todo el servidor con kill_session, kill_window, kill_pane o kill_server.
  • Suprimir el historial del shell — Iniciar paneles con suppress_persistent_history para mantener las ejecuciones de prueba y comandos puntuales fuera del historial persistente del shell.

Documentación

libtmux-mcp¶

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. Algunas herramientas leen el estado. Otras lo modifican. Algunas lo destruyen. La distinción es explícita y se aplica estrictamente.

Advertencia

Pre-alpha. Las APIs pueden cambiar. Se agradecen los comentarios.

Claude Code Claude Desktop Codex CLI Gemini CLI Cursor Grok CLI Antigravity

uvx pipx pip install

¿Configurar períodos de espera?

Local Usuario Proyecto

Usuario Proyecto

Usuario Proyecto

Proyecto Global

Usuario Proyecto

Con uvx instalado:

$ claude mcp add tmux -- uvx libtmux-mcp

Volver

Períodos de espera de dependencias

Usa la casilla Configurar períodos de espera de arriba para activar o desactivar. Estos ajustes eligen cómo se comporta el período de espera una vez activado.

¿Qué son los períodos de espera?

Los períodos de espera retrasan la recogida de paquetes recién subidos para que la comunidad tenga tiempo de detectar ataques a la cadena de suministro antes de que instales. La mayoría de los gestores de paquetes no aplican uno por defecto — te unes voluntariamente mediante un ajuste global en la configuración de tu herramienta.

Más información en cooldowns.dev · artículo de Datadog Security Labs.

Inicio rápido

Instala, conecta, obtén un primer resultado. En menos de 2 minutos.

Inicio rápido

Herramientas

Cada herramienta, agrupada por intención y nivel de seguridad.

Herramientas

Indicaciones

Cuatro recetas de flujo de trabajo que el cliente renderiza para el modelo.

Indicaciones

Recursos

Vistas instantáneas de la jerarquía de tmux a través de URIs tmux://.

Recursos

Niveles de seguridad

Solo lectura, modificación, destructivo. Conoce qué cambia el estado.

Niveles de seguridad

Configuración del cliente

Bloques de configuración para Claude Desktop, Claude Code, Cursor y otros.

Clientes MCP

Qué puedes hacer¶

Inspeccionar solo lectura¶

Lee el estado de tmux sin cambiar nada.

list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · wait_for_content_change · display_message · call_readonly_tools_batch

Actuar modificando¶

Crea o modifica objetos de tmux.

create_session · send_keys · send_keys_batch · run_command · paste_text · create_window · split_window · select_pane · select_window · move_window · resize_pane · pipe_pane · set_option · call_mutating_tools_batch

Destruir destructivo¶

Desmantela objetos de tmux. No es reversible.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Ejemplo: mantener las ejecuciones de prueba 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 utilizan supresión de comandos ligera por defecto. Cuando creas una nueva shell, opta por controles más fuertes sin disco consuppress_persistent_history=true.

Indicación

Crea una sesión de tmux llamada “checks” con controles de historial de shell sin disco de mejor esfuerzo, ejecuta pytest -q en su panel inicial y muéstrame el resultado.

El agente llama a create_session consuppress_persistent_history=true, reutiliza active_pane_id delSessionInfo devuelto, y llama arun_command sin una anulación. La misma opción de generación encreate_window, split_window, orespawn_pane se aplica solo al proceso que esa llamada inicia.

Estos controles reducen el ruido del historial; no hacen que los comandos sean secretos. ConsultaSupresión de historial para el comportamiento específico de la shell,Configuración para el valor predeterminado del servidor, y Niveles de seguridad 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)
  • Leer vs. modificar — algunas herramientas observan, otras actúan, otras destruyen (Niveles de seguridad)
  • tmux es la fuente de verdad — el servidor lee de él y escribe en él, nunca almacena en caché ni abstrae