libtmux-mcp server

oficial

Servidor MCP tmux alimentado por libtmux

Ver em git-pull.comExperimente este MCPPatrocinado

O que você pode fazer com Libtmux MCP?

  • Inspecionar o estado do tmux — Solicite um snapshot somente leitura de sessões, janelas ou painéis via list_sessions, capture_pane ou get_pane_info.
  • Executar comandos em painéis — Faça o assistente executar comandos de shell ou enviar teclas com run_command ou send_keys, incluindo operações em lote.
  • Gerenciar objetos do tmux — Crie, divida, redimensione ou selecione janelas e painéis usando ferramentas como create_window, split_window ou select_pane.
  • Destruir recursos do tmux — Encerre sessões, janelas, painéis ou o servidor inteiro com ferramentas destrutivas como kill_session ou kill_server.
  • Suprimir histórico do shell — Inicie sessões ou janelas com suppress_persistent_history=true para manter execuções de teste fora do histórico persistente do shell.

Documentação

libtmux-mcp¶

Controle de terminal para agentes de IA, construído sobre libtmux e FastMCP.

Este servidor mapeia a hierarquia de objetos do tmux — sessões, janelas, painéis — em ferramentas MCP. Algumas ferramentas leem o estado. Outras o modificam. Algumas destroem. A distinção é explícita e aplicada.

Aviso

Pré-alfa. As APIs podem mudar. Feedback é bem-vindo.

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

uvx pipx pip install

Configurar cooldowns ?

Local Usuário Projeto

Usuário Projeto

Usuário Projeto

Projeto Global

Usuário Projeto

Com uvx instalado:

$ claude mcp add tmux -- uvx libtmux-mcp

Voltar

Cooldowns de dependência

Use a caixa de seleção Configurar cooldowns acima para ativar ou desativar. Essas configurações escolhem como o cooldown se comporta uma vez ativado.

O que são cooldowns?

Cooldowns atrasam a coleta de pacotes recém-carregados para que a comunidade tenha tempo de identificar ataques à cadeia de suprimentos antes de você instalar. A maioria dos gerenciadores de pacotes não aplica um por padrão — você opta por ativar via uma configuração global nas configurações da sua ferramenta.

Saiba mais em cooldowns.dev · Análise do Datadog Security Labs.

Início rápido

Instale, conecte, obtenha o primeiro resultado. Em menos de 2 minutos.

Início rápido

Ferramentas

Cada ferramenta, agrupada por intenção e nível de segurança.

Ferramentas

Prompts

Quatro receitas de fluxo de trabalho que o cliente renderiza para o modelo.

Prompts

Recursos

Vistas de instantâneo da hierarquia do tmux via URIs tmux://.

Recursos

Níveis de segurança

Somente leitura, mutável, destrutivo. Saiba o que altera o estado.

Níveis de segurança

Configuração do cliente

Blocos de configuração para Claude Desktop, Claude Code, Cursor e outros.

Clientes MCP

O que você pode fazer¶

Inspecionar somente leitura¶

Leia o estado do tmux sem alterar 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

Agir mutável¶

Crie ou modifique objetos do 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 destrutivo¶

Derrube objetos do tmux. Não é reversível.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Exemplo: manter execuções de teste fora do histórico persistente¶

libtmux-mcp fornece supressão de histórico de melhor esforço para Bash, Zsh e Fish. Chamadas MCP para run_command usam supressão de comando leve por padrão. Quando você cria um novo shell, opte por controles mais fortes de não gravação em disco comsuppress_persistent_history=true.

Prompt

Crie uma sessão tmux chamada “checks” com controles de histórico de shell de melhor esforço sem gravação em disco, execute pytest -q no painel inicial e mostre-me o resultado.

O agente chama create_session comsuppress_persistent_history=true, reutiliza active_pane_id do SessionInfo retornado e chamarun_command sem uma substituição. A mesma opção de spawn emcreate_window, split_window ourespawn_pane aplica-se apenas ao processo que essa chamada inicia.

Esses controles reduzem o ruído do histórico; eles não tornam os comandos secretos. Veja Supressão de histórico para comportamento específico do shell, Configuração para o padrão do servidor e Níveis de segurança para outras superfícies de observação.

Navegar por todas as ferramentas →

Modelo mental¶

  • Hierarquia de objetos — sessões contêm janelas, janelas contêm painéis (Conceitos)
  • Leitura vs. mutação — algumas ferramentas observam, algumas agem, algumas destroem (Níveis de segurança)
  • tmux é a fonte da verdade — o servidor lê dele e escreve nele, nunca armazena em cache ou abstrai