tmux-mcp-tools

tmux-mcp-tools

0
os_automation

tmux-mcp-tools provides tools for interacting with tmux sessions, allowing users to capture pane content, send commands and keys, and write files. It uses a custom configuration and templates for an AI agent.

tmux-mcp-tools

Provide MCP tools for interacting with tmux sessions.

Configuration

  • Custom XDG: $XDG_CONFIG_HOME/tmux-mcp-tools/
  • mcp.json: MCP server configuration following Cursor format
  • prompt.md: System prompt template for the AI agent

Tmux Configuration

Add the following to your .tmux.conf file to create a keybinding that opens the client in a new pane:

bind-key M-k split-window -h -p 33 "uvx --from tmux-mcp-tools tmux-agent --target \"$(tmux display-message -t ! -p '#{pane_id}')\" ;"

This will bind Alt+K to open a new pane with the client, targeting the current pane.

Features

Tmux Tools

  • tmux_capture_pane: Capture the content of a tmux pane
  • tmux_send_command: Send commands to a tmux pane with automatic Enter key
  • tmux_send_keys: Send keys to a tmux pane without automatic Enter
  • tmux_write_file: Write content to a file using heredoc pattern in a tmux pane

Usage

{
  "mcpServers": {
    "tmux-mcp-tools": {
      "command": "uvx",
      "args": ["tmux-mcp-tools"]
    }
  }
}