# create_window

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

> Creates a window whose first pane runs the configured process. 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.

Creates a window whose first pane runs the configured process. Start a pane’s configured process; accepts no command payload.

[All Java tools](https://libtmux.org/en/java/latest/mcp/tools/) · [JSON](https://libtmux.org/en/java/latest/mcp/tools/create_window.json) · [Source](https://github.com/libtmux/libtmux-java/blob/f56392b5d9bc7f1f9c1631842333fb90f3d82d40/libtmux-mcp/src/main/java/io/github/libtmux/mcp/ExecuteTools.java#L67)

## Arguments

* `attach` optional · boolean

  Make the new window active. Defaults to false.

  Default: `false`.

* `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": {
      "default": false,
      "description": "Make the new window active. Defaults to false.",
      "type": "boolean"
    },
    "direction": {
      "description": "before or 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": {
    "active": {
      "type": "boolean"
    },
    "id": {
      "type": "string"
    },
    "index": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "panes": {
      "type": "integer"
    },
    "session_id": {
      "type": "string"
    },
    "size": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "index",
    "name",
    "session_id",
    "active",
    "panes",
    "size"
  ],
  "type": "object"
}
```

Tool annotations

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