# create_window

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

> Start a pane's configured process; accepts no command payload. Create a window with a configured pane process.

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 with a configured pane process.

[All Swift tools](https://libtmux.org/en/swift/latest/mcp/tools/) · [JSON](https://libtmux.org/en/swift/latest/mcp/tools/create_window.json) · [Source](https://github.com/libtmux/libtmux-swift/blob/63551afeae8ea3d272e5262208b87735888daf5f/Sources/LibTmuxMCP/ToolOperation.swift#L38)

## Arguments

* `name` optional · string

  Caller-controlled name.

* `session` required · string

  Caller-controlled session.

* `startDirectory` optional · string

  Caller-controlled startDirectory.

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "name": {
      "description": "Caller-controlled name.",
      "type": "string"
    },
    "session": {
      "description": "Caller-controlled session.",
      "type": "string"
    },
    "startDirectory": {
      "description": "Caller-controlled startDirectory.",
      "type": "string"
    }
  },
  "required": [
    "session"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "height": {
      "type": "integer"
    },
    "id": {
      "type": "string"
    },
    "index": {
      "type": "integer"
    },
    "isActive": {
      "type": "boolean"
    },
    "linkRef": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "paneCount": {
      "type": "integer"
    },
    "sessionID": {
      "type": "string"
    },
    "target": {
      "type": "string"
    },
    "width": {
      "type": "integer"
    },
    "windowRef": {
      "type": "string"
    }
  },
  "required": [
    "height",
    "id",
    "index",
    "isActive",
    "linkRef",
    "name",
    "paneCount",
    "sessionID",
    "target",
    "width",
    "windowRef"
  ],
  "type": "object"
}
```

Tool annotations

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