libtmux-mcp server

oficial

Servidor MCP de tmux impulsado por libtmux

Ver en git-pull.comPrueba este MCPPatrocinado

¿Qué puedes hacer con Libtmux MCP?

  • Inspeccionar el estado de tmux — Solicita una instantánea de solo lectura de sesiones, ventanas o paneles mediante list_sessions, capture_pane o get_pane_info.
  • Ejecutar comandos en paneles — Haz que el asistente ejecute comandos de shell o envíe pulsaciones de teclas con run_command o send_keys, incluyendo operaciones por lotes.
  • Gestionar objetos de tmux — Crea, divide, redimensiona o selecciona ventanas y paneles usando herramientas como create_window, split_window o select_pane.
  • Destruir recursos de tmux — Derriba sesiones, ventanas, paneles o todo el servidor con herramientas destructivas como kill_session o kill_server.
  • Suprimir el historial del shell — Inicia sesiones o ventanas con suppress_persistent_history=true para mantener las ejecuciones de pruebas 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 mutan. Algunas destruyen. La distinción es explícita y se aplica.

Advertencia

Pre-alfa. Las API pueden cambiar. Se agradecen comentarios.

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

uvx pipx pip install

Configurar períodos de enfriamiento ?

Local Usuario Proyecto

Usuario Proyecto

Usuario Proyecto

Proyecto Global

Usuario Proyecto

Con uvx instalado:

$ claude mcp add tmux -- uvx libtmux-mcp

Atrás

Períodos de enfriamiento de dependencias

Usa la casilla Configurar períodos de enfriamiento de arriba para habilitar o deshabilitar. Estos ajustes determinan cómo se comporta el período de enfriamiento una vez habilitado.

¿Qué son los períodos de enfriamiento?

Los períodos de enfriamiento retrasan la adopción 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 — se opta mediante un ajuste global en la configuración de tu herramienta.

Aprende más en cooldowns.dev · Informe 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

Prompts

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

Prompts

Recursos

Vistas de instantánea de la jerarquía de tmux mediante URIs tmux://.

Recursos

Niveles de seguridad

Solo lectura, mutació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 · display_message · call_readonly_tools_batch

Actuar mutando¶

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)¶

Desmonta objetos de tmux. No reversible.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Ejemplo: mantener las 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 de comandos ligera por defecto. Cuando creas una nueva shell, opta por controles más fuertes de no-disk con suppress_persistent_history=true.

Prompt

Crea una sesión de tmux llamada "checks" con controles de historial de shell de no-disk de mejor esfuerzo, ejecuta pytest -q en 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 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. mutar — algunas herramientas observan, algunas actúan, algunas 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