# create_window

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

> Start a pane's configured process; accepts no command payload. Creates a window whose first pane runs the configured 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. Creates a window whose first pane runs the configured process.

[All Go tools](https://libtmux.org/en/go/latest/mcp/tools/) · [JSON](https://libtmux.org/en/go/latest/mcp/tools/create_window.json) · [Source](https://github.com/libtmux/libtmux-go/blob/aaf86678fe0cbdf56f9e1c9c46b0db0704e15656/mcp/manifest_catalog.go#L452)

## Arguments

* `attach` optional · boolean

  make the new window active

* `direction` optional · string

  before or after

* `session_id` required · string

  the session id, such as $1

* `start_directory` optional · string

  an absolute literal start directory

* `window_name` optional · string

  a literal window name

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "attach": {
      "description": "make the new window active",
      "type": "boolean"
    },
    "direction": {
      "description": "before or after",
      "enum": [
        "before",
        "after"
      ],
      "type": "string"
    },
    "session_id": {
      "description": "the session id, such as $1",
      "type": "string"
    },
    "start_directory": {
      "description": "an absolute literal start directory",
      "type": "string"
    },
    "window_name": {
      "description": "a literal window name",
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "paneId": {
      "type": "string"
    },
    "windowId": {
      "type": "string"
    }
  },
  "required": [
    "windowId",
    "paneId"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "openWorldHint": true,
  "title": "Create a window"
}
```