
Lets LLMs control tmux sessions over SSH with full state awareness instead of hallucination. You get session discovery, pane/window management, scrollback capture, and keystroke injection with explicit targeting. Built for pairing with an AI on live systems: the model can spawn remote sessions, read actual terminal output, manage splits, and execute commands in the correct pane. Destructive operations require confirmation flags. Includes batch capture across multiple panes, tail tasks for following output, and layout save/restore. Useful when you want an LLM to help debug across several terminals or automate multi-pane workflows without losing track of which shell is which.
MCP_TMUX_HOSTOptional default SSH host alias to use when none is provided.
MCP_TMUX_SESSIONOptional default tmux session name to use when none is provided.
TMUX_BINOptional path to tmux binary if not on PATH.
MCP_TMUX_TIMEOUT_MSTimeout in milliseconds for tmux/ssh invocations (default 15000).
MCP_TMUX_LOG_DIROverride log directory (defaults to ~/.config/mcp-tmux/logs).
MCP_TMUX_HOSTS_FILEOptional JSON file for per-host tmux PATH/bin overrides.