# create_session

Source: https://libtmux.org/en/csharp/latest/mcp/tools/create_session/

> Start a pane's configured process; accepts no command payload. Create a detached tmux session and return its ids. Give a width and height when nothing will attach to it: a session with no client keeps tmux's default 80x24, which truncates wide output.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

Start a pane’s configured process; accepts no command payload. Create a detached tmux session and return its ids. Give a width and height when nothing will attach to it: a session with no client keeps tmux’s default 80x24, which truncates wide output.

[All C# tools](https://libtmux.org/en/csharp/latest/mcp/tools/) · [JSON](https://libtmux.org/en/csharp/latest/mcp/tools/create_session.json) · [Source](https://github.com/libtmux/libtmux-dotnet/blob/cf34b255c896d19a97e7d7fabea58609c916012d/src/LibTmux.Mcp/Policy/CapabilityModel.cs#L603)

## Arguments

* `height` optional · integer | null

  Rows. Omit for tmux's default of 24.

  Default: `null`.

* `name` optional · string | null

  The session name. Omit and tmux names it with a number.

  Default: `null`.

* `startDirectory` optional · string | null

  The literal starting directory. Omit for the MCP server's own working directory.

  Default: `null`.

* `width` optional · integer | null

  Columns. Omit for tmux's default of 80.

  Default: `null`.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "height": {
      "default": null,
      "description": "Rows. Omit for tmux's default of 24.",
      "maximum": 2147483647,
      "minimum": -2147483648,
      "type": [
        "integer",
        "null"
      ]
    },
    "name": {
      "default": null,
      "description": "The session name. Omit and tmux names it with a number.",
      "type": [
        "string",
        "null"
      ]
    },
    "startDirectory": {
      "default": null,
      "description": "The literal starting directory. Omit for the MCP server's own working directory.",
      "type": [
        "string",
        "null"
      ]
    },
    "width": {
      "default": null,
      "description": "Columns. Omit for tmux's default of 80.",
      "maximum": 2147483647,
      "minimum": -2147483648,
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}
```

Output schema

```json
{
  "properties": {
    "changed": {
      "type": "string"
    },
    "paneId": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "sessionId": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "windowId": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "changed"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false,
  "title": "Create session"
}
```