Skip to main content
Glama
WENLIXIAO-CS

tmux-mcp

by WENLIXIAO-CS

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
tmux_list_sessionsA

List all tmux sessions with their names, IDs, window count, and status.

tmux_list_windowsA

List all tmux windows. Optionally filter by session name or ID.

Args: session: Session name or ID to filter by. If omitted, lists windows from all sessions.

tmux_send_keysA

Send keys or commands to a tmux pane.

Args: target: Tmux target (e.g. "session:window.pane", "session:window", "session"). keys: Keys to send. Use special key names like "Enter", "C-c", "Escape", "Tab", "Space", etc. literal: If true, send keys literally (the -l flag) without special key lookup.

tmux_read_paneA

Read/capture content from a tmux pane.

Args: target: Tmux target (e.g. "session:window.pane"). line_count: Number of lines to capture. If omitted, captures entire visible pane. start_line: Start line for history capture (negative = lines before visible area, e.g. -100).

tmux_create_sessionA

Create a new tmux session.

Args: name: Name for the new session. command: Optional command to run in the initial window. window_name: Optional name for the first window.

tmux_create_windowA

Create a new window in an existing tmux session.

Args: session: Target session name or ID. name: Optional name for the new window. command: Optional command to run in the new window.

tmux_rename_sessionA

Rename a tmux session.

Args: old_name: Current session name or ID. new_name: New name for the session.

tmux_rename_windowA

Rename a tmux window.

Args: target: Tmux target for the window (e.g. "session:window"). new_name: New name for the window.

tmux_select_windowA

Navigate/switch to a specific tmux window.

Args: target: Tmux target (e.g. "session:window").

tmux_list_panesA

List tmux panes with their IDs, dimensions, and status.

Args: target: Session or window target (e.g. "mysession", "mysession:0"). If omitted, lists panes from all sessions.

tmux_split_windowA

Split a window/pane to create a new pane.

Args: target: Target window or pane to split (e.g. "session:window", "session:window.pane", or "%3"). horizontal: If true, split horizontally (top/bottom). Default is vertical (left/right). size: Size of new pane — percentage (e.g. "50%") or line/column count (e.g. "20"). command: Optional command to run in the new pane.

tmux_select_paneA

Select/focus a specific tmux pane.

Args: target: Pane target (e.g. "session:window.pane", "%3").

tmux_resize_paneA

Resize a tmux pane.

Use direction+amount for relative resize, or width/height for absolute resize.

Args: target: Pane target (e.g. "%3", "session:window.pane"). direction: Direction to grow: "up", "down", "left", or "right". amount: Number of cells to resize by (default 5). Used with direction. width: Absolute width in columns. Overrides direction/amount. height: Absolute height in rows. Overrides direction/amount.

tmux_killA

Kill a tmux session, window, or pane.

Args: target: Tmux target to kill. type: What to kill - "session", "window", or "pane".

tmux_read_cc_paneA

Monitor a tmux pane running Claude Code, auto-waiting and auto-approving.

Polls the pane in a loop:

  • While Claude Code is processing (spinners, "Running…", activity text): logs the status and sleeps.

  • When Claude Code asks for permission (numbered options): sends "1" to approve and continues monitoring.

  • When Claude Code is idle (waiting for next prompt): returns the captured pane content.

Args: target: Tmux target pane (e.g. "session:window.pane", "%3"). timeout: Max seconds to wait before returning (default 1800). poll_interval: Seconds between polls (default 0.5). last_n_lines: Number of trailing non-empty lines to analyze (default 20).

remote_bash_connectA

Connect to a remote host via SSH with a persistent shell session.

Shell state (working directory, environment variables) persists across subsequent remote_bash_execute calls to the same connection.

Args: host: Hostname or IP address. username: SSH username. Defaults to current local username. port: SSH port (default 22). password: SSH password (optional; prefer key-based auth). key_filename: Path to private key file (optional; defaults to SSH agent). connection_id: Optional alias for this connection (default: "user@host:port"). connect_timeout: Timeout in seconds for the connection attempt.

remote_bash_executeA

Execute a command on a remote host via an established SSH connection.

Shell state (working directory, environment variables, aliases) persists across calls to the same connection_id.

Args: command: Shell command to execute. connection_id: Which connection to use. If omitted, uses the most recently active connection. timeout: Max seconds to wait for the command to complete (default 120).

remote_bash_disconnectA

Disconnect an SSH connection or all connections.

Args: connection_id: Which connection to close. Required if all is false. all: If true, disconnect all active connections.

remote_bash_list_connectionsA

List all active SSH connections with their status and idle time.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WENLIXIAO-CS/tmux-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server