# create_window

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

> Create a detached window; name and path data are literalized before tmux expansion. Start a pane's configured process; accepts no command payload.

MCP is in development

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

Create a detached window; name and path data are literalized before tmux expansion. Start a pane’s configured process; accepts no command payload.

[All C++ tools](https://libtmux.org/en/cxx/latest/mcp/tools/) · [JSON](https://libtmux.org/en/cxx/latest/mcp/tools/create_window.json) · [Source](https://github.com/libtmux/libtmux-cxx/blob/96f367a6fe247e4e5ebddd4a52ca5d5f9d07c0ec/apps/mcp/src/tool_catalog.cpp#L2587)

## Arguments

* `name` optional · string

  Optional literal window name.

* `session` required · string

  Stable owning session ID or name.

* `startDirectory` optional · string

  Literal pane start directory.

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "name": {
      "description": "Optional literal window name.",
      "maxLength": 512,
      "type": "string"
    },
    "session": {
      "description": "Stable owning session ID or name.",
      "maxLength": 512,
      "type": "string"
    },
    "startDirectory": {
      "description": "Literal pane start directory.",
      "maxLength": 4096,
      "type": "string"
    }
  },
  "required": [
    "session"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "session_id": {
      "pattern": "^\\$[0-9]+$",
      "type": "string"
    },
    "window_id": {
      "pattern": "^@[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "session_id",
    "window_id"
  ],
  "type": "object"
}
```

Tool annotations

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