Tmux MCP Server

Instructions

Implementation Reference

• src/index.js:408-427 (handler)

  The main handler function for tmux_select_pane tool. It executes the tmux select-pane command using the provided session_name and pane_index arguments.

  async selectPane(args) {
    const { session_name, pane_index } = args;
  
    try {
      await execAsync(
        `tmux select-pane -t "${session_name}:${pane_index}"`
      );
  
      return {
        content: [
          {
            type: "text",
            text: `Selected pane ${pane_index} in session ${session_name}`,
          },
        ],
      };
    } catch (error) {
      throw new Error(`Failed to select pane: ${error.message}`);
    }
  }

• src/index.js:153-166 (schema)

  Input schema definition for the tmux_select_pane tool, specifying session_name and pane_index as required string parameters.

  inputSchema: {
    type: "object",
    properties: {
      session_name: {
        type: "string",
        description: "Name of the tmux session",
      },
      pane_index: {
        type: "string",
        description: "Pane index to select (e.g., '0', '1', '2')",
      },
    },
    required: ["session_name", "pane_index"],
  },

• src/index.js:149-167 (registration)

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

  {
    name: "tmux_select_pane",
    description:
      "Select a specific pane in a tmux session to make it active for commands.",
    inputSchema: {
      type: "object",
      properties: {
        session_name: {
          type: "string",
          description: "Name of the tmux session",
        },
        pane_index: {
          type: "string",
          description: "Pane index to select (e.g., '0', '1', '2')",
        },
      },
      required: ["session_name", "pane_index"],
    },
  },

• src/index.js:203-204 (registration)

  Switch case in CallToolRequestHandler that maps tmux_select_pane to the selectPane method.

  case "tmux_select_pane":
    return await this.selectPane(args);