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 — Peça para listar sessões, capturar a saída do painel ou pesquisar painéis por texto específico.
  • Gerenciar a estrutura do tmux — Renomeie sessões, redimensione painéis, selecione layouts ou mova janelas entre sessões.
  • Executar comandos em painéis — Crie sessões/janelas, divida painéis, envie teclas ou execute comandos de shell.
  • Controlar processos do painel — Cole texto ou buffers, canalize a saída do painel ou defina variáveis de ambiente e opções.
  • Encerrar objetos do tmux — Limpe o histórico de rolagem do painel, encerre sessões/janelas/painéis ou exclua buffers.
  • Suprimir o histórico do shell — Crie sessões ou janelas com controles de histórico sem disco para execuções de teste mais limpas.

Documentação

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 agrupadas pela operação que solicitam. O servidor aplica os grupos selecionados no limite da ferramenta MCP.

[!warning] Aviso Pré-alfa. As APIs podem mudar. Feedback bem-vindo.

Com o uvx instalado:

$ claude mcp add tmux -- uvx libtmux-mcp

Início rápido

Início rápido

Ferramentas

Ferramentas

Prompts

Prompts

Recursos

Recursos

Modelo de confiança

Modelo de confiança

Configuração do cliente

Clientes MCP

O que você pode fazer

Inspecionar inspecionar

Solicite o estado do tmux e a saída do 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

Gerenciar gerenciar

Altere a estrutura ou a apresentação do tmux.

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

Executar executar

Inicie ou conduza processos de painel, ou armazene estado que possa controlar execuções 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

Exclua objetos do tmux ou o histórico de rolagem retido. Não é reversível.

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

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. Ao criar um novo shell, opte por controles mais fortes de não gravação em disco com suppress_persistent_history=true.

[!note] 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 com suppress_persistent_history=true, reutiliza active_pane_id do SessionInfo retornado e chama run_command sem uma substituição. A mesma opção de spawn em create_window, split_window ou respawn_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. Consulte Supressão de histórico para comportamento específico de shell, Configuração para o padrão do servidor e Modelo de confiança para outras superfícies de observação.

Explorar todas as ferramentas →

Modelo mental

  • Hierarquia de objetos — sessões contêm janelas, janelas contêm painéis (Conceitos)
  • Conjuntos de ferramentas — inspecionar, gerenciar, executar, desmontar; o que cada um agrupa (Modelo de confiança)
  • tmux é a fonte da verdade — o servidor lê dele e escreve nele, nunca armazena em cache nem abstrai