tmux_create_session

Create a new tmux terminal session with optional name and starting directory for SSH access, command execution, and terminal automation.

Instructions

Create a new tmux session. If no name is provided, tmux will generate one. Returns session name.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`session_name`	No	Name for the tmux session (optional)
`start_directory`	No	Starting directory for the session (optional)

Implementation Reference

src/index.js:224-259 (handler)

The handler function that implements the tmux_create_session tool. It constructs a tmux new-session command with optional session name and start directory, executes it asynchronously, retrieves the actual session name if not provided, and returns a success message.

async createSession(args) {
  const { session_name, start_directory } = args;
  let cmd = "tmux new-session -d";

  if (session_name) {
    cmd += ` -s "${session_name}"`;
  }

  if (start_directory) {
    cmd += ` -c "${start_directory}"`;
  }

  try {
    await execAsync(cmd);

    // If no session name was provided, get the name of the last created session
    let actualSessionName = session_name;
    if (!session_name) {
      const { stdout } = await execAsync(
        "tmux list-sessions -F '#{session_name}' | tail -1"
      );
      actualSessionName = stdout.trim();
    }

    return {
      content: [
        {
          type: "text",
          text: `Created tmux session: ${actualSessionName}`,
        },
      ],
    };
  } catch (error) {
    throw new Error(`Failed to create session: ${error.message}`);
  }
}

src/index.js:43-55 (schema)

Input schema definition for the tmux_create_session tool, specifying optional string parameters for session_name and start_directory.

inputSchema: {
  type: "object",
  properties: {
    session_name: {
      type: "string",
      description: "Name for the tmux session (optional)",
    },
    start_directory: {
      type: "string",
      description: "Starting directory for the session (optional)",
    },
  },
},

src/index.js:39-56 (registration)

Registration of the tmux_create_session tool in the ListTools response, including name, description, and input schema.

{
  name: "tmux_create_session",
  description:
    "Create a new tmux session. If no name is provided, tmux will generate one. Returns session name.",
  inputSchema: {
    type: "object",
    properties: {
      session_name: {
        type: "string",
        description: "Name for the tmux session (optional)",
      },
      start_directory: {
        type: "string",
        description: "Starting directory for the session (optional)",
      },
    },
  },
},

src/index.js:191-192 (registration)
Registration in the CallToolRequestHandler switch statement that routes calls to the createSession handler method.
```
case "tmux_create_session":
  return await this.createSession(args);
```

Tmux MCP Server