# list_windows

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

> Inspect tmux metadata; accepts no client-supplied executable input. List windows, optionally within one session.

MCP is in development

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

Inspect tmux metadata; accepts no client-supplied executable input. List windows, optionally within one session.

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

## Arguments

* `session` optional · string

  Caller-controlled session.

## Schemas

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

Input schema

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

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "windows": {
      "items": {
        "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"
      },
      "type": "array"
    }
  },
  "required": [
    "windows"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false,
  "title": "List windows"
}
```