tmux_split_window

Split tmux terminal windows horizontally or vertically to create new panes for parallel command execution and terminal automation.

Instructions

Split the current window in a tmux session horizontally or vertically to create a new pane.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`session_name`	Yes	Name of the tmux session
`vertical`	No	If true, split vertically (side by side). If false, split horizontally (top and bottom). Default: false

Implementation Reference

src/index.js:381-406 (handler)

Handler function that splits the tmux window horizontally or vertically based on the vertical parameter using tmux split-window command.

async splitWindow(args) {
  const { session_name, vertical = false } = args;

  try {
    let cmd = `tmux split-window -t "${session_name}"`;

    if (vertical) {
      cmd += " -h"; // horizontal split creates vertical panes (side by side)
    }

    await execAsync(cmd);

    return {
      content: [
        {
          type: "text",
          text: `Split window in session ${session_name} (${
            vertical ? "vertically" : "horizontally"
          })`,
        },
      ],
    };
  } catch (error) {
    throw new Error(`Failed to split window: ${error.message}`);
  }
}

src/index.js:133-147 (schema)

Input schema defining parameters for the tmux_split_window tool: session_name (required string), vertical (optional boolean).

inputSchema: {
  type: "object",
  properties: {
    session_name: {
      type: "string",
      description: "Name of the tmux session",
    },
    vertical: {
      type: "boolean",
      description:
        "If true, split vertically (side by side). If false, split horizontally (top and bottom). Default: false",
    },
  },
  required: ["session_name"],
},

src/index.js:129-148 (registration)

Tool registration in the ListTools response, including name, description, and input schema.

{
  name: "tmux_split_window",
  description:
    "Split the current window in a tmux session horizontally or vertically to create a new pane.",
  inputSchema: {
    type: "object",
    properties: {
      session_name: {
        type: "string",
        description: "Name of the tmux session",
      },
      vertical: {
        type: "boolean",
        description:
          "If true, split vertically (side by side). If false, split horizontally (top and bottom). Default: false",
      },
    },
    required: ["session_name"],
  },
},

src/index.js:201-202 (registration)
Dispatch case in the CallToolRequestHandler switch statement that routes to the splitWindow handler.
```
case "tmux_split_window":
  return await this.splitWindow(args);
```

Tmux MCP Server