# create_window

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

> Create a window running its 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.

Create a window running its configured process. Start a pane’s configured process; accepts no command payload.

[All Rust tools](https://libtmux.org/en/rs/latest/mcp/tools/) · [JSON](https://libtmux.org/en/rs/latest/mcp/tools/create_window.json) · [Source](https://github.com/libtmux/libtmux-rs/blob/2cef1aa642182dd1970c3688feb6a568ff666e64/crates/tmux-mcp/src/tools/contract.rs#L927)

## Arguments

* `name` optional · string | null

  The window name. Omit to let tmux name it after its running command.

* `session` required · string

  The session to create the window in, by \`$\`-prefixed id or name.

* `start_directory` optional · string | null

  The window's working directory. Omit for the directory this MCP server started in.

## Schemas

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

Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "name": {
      "description": "The window name. Omit to let tmux name it after its running command.",
      "type": [
        "string",
        "null"
      ]
    },
    "session": {
      "description": "The session to create the window in, by `$`-prefixed id or name.",
      "type": "string"
    },
    "start_directory": {
      "description": "The window's working directory. Omit for the directory this MCP\nserver started in.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "session"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "active": {
      "description": "Whether this is the session's active window.",
      "type": "boolean"
    },
    "id": {
      "description": "The `@`-prefixed tmux identity.",
      "type": "string"
    },
    "index": {
      "description": "The window's index within that session.",
      "format": "int32",
      "type": "integer"
    },
    "linked": {
      "description": "Whether more than one session links this window.",
      "type": "boolean"
    },
    "name": {
      "description": "The window name.",
      "type": "string"
    },
    "panes": {
      "description": "How many panes the window holds.",
      "minimum": 0,
      "type": "integer"
    },
    "session_id": {
      "description": "The session this window was reached through.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "session_id",
    "index",
    "name",
    "panes",
    "active",
    "linked"
  ],
  "type": "object"
}
```

Tool annotations

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