# create_window

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

> Start a pane's configured process; accepts no command payload. Create a window in a tmux session and return its ids.

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 window in a tmux session and return its ids.

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

## Arguments

* `name` optional · string | null

  The window name. Omit and tmux names it after the program it runs.

  Default: `null`.

* `session` optional · string | null

  A session id or name. Omit for the first session.

  Default: `null`.

* `startDirectory` optional · string | null

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

  Default: `null`.

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "name": {
      "default": null,
      "description": "The window name. Omit and tmux names it after the program it runs.",
      "type": [
        "string",
        "null"
      ]
    },
    "session": {
      "default": null,
      "description": "A session id or name. Omit for the first session.",
      "type": [
        "string",
        "null"
      ]
    },
    "startDirectory": {
      "default": null,
      "description": "The literal starting directory. Omit for the MCP server's own working directory.",
      "type": [
        "string",
        "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 window"
}
```