tmux-mcp

tmux-mcp

tmux-mcp gives AI assistants full control over your tmux sessions.

Observe your AI agent in real-time

Set TMUX_MCP_ALWAYS_USE=true to force the agent to run every shell command through a named tmux session instead of direct Bash. Watch exactly what your AI is doing, live in your terminal — every command, every output, nothing hidden.

What it can do

• List sessions, windows, and panes
• Capture live terminal output from any pane
• Send commands and key sequences (Ctrl-C, Escape, arrows)
• Create sessions, windows, and split panes with a working directory and initial command
• Kill and rename sessions, windows, and panes
• Auto-routes all shell commands through tmux when configured

Install

npm install -g @fr1sk/tmux-mcp

Configure

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp"
    }
  }
}

With agent observability

{
  "mcpServers": {
    "tmux": {
      "command": "tmux-mcp",
      "env": {
        "TMUX_MCP_ALWAYS_USE": "true",
        "TMUX_MCP_DEFAULT_SESSION": "agent"
      }
    }
  }
}

Works with Claude Code, OpenCode, Cursor, Windsurf, Cline, Roo Code, Continue, Codex, and any MCP-compatible AI assistant.