libtmux-mcp server

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 estado. Outras o modificam. Algumas destroem. A distinção é explícita e aplicada.

Aviso

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

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

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 habilitar ou desabilitar. Essas configurações determinam como o cooldown se comporta uma vez habilitado.

O que são cooldowns?

Cooldowns atrasam a obtenção de pacotes recém-enviados para que a comunidade tenha tempo de detectar ataques à cadeia de suprimentos antes de você instalar. A maioria dos gerenciadores de pacotes não aplica um por padrão — você opta por participar através de uma configuração global nas definições da sua ferramenta.

Saiba mais em cooldowns.dev · Artigo do Datadog Security Labs.

---

Início rápido

Instale, conecte, obtenha um 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

Visões instantâneas 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¶

Ler 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 · wait_for_content_change · display_message · call_readonly_tools_batch

Agir mutável¶

Criar ou modificar 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¶

Desmontar 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. Ao criar um novo shell, opte por controles mais fortes sem disco com suppress_persistent_history=true.

Prompt

Crie uma sessão tmux chamada “checks” com controles de histórico de shell sem disco de melhor esforço, execute pytest -q em seu 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. 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.

Navegue por todas as ferramentas →

---

Modelo mental¶

• Hierarquia de objetos — sessões contêm janelas, janelas contêm painéis (Conceitos)
• Ler vs. modificar — 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

---