# list_windows

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

> Inspect tmux metadata; accepts no client-supplied executable input. Windows on this server, optionally restricted to one session by id or name.

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. Windows on this server, optionally restricted to one session by id or name.

[All TypeScript tools](https://libtmux.org/en/ts/latest/mcp/tools/) · [JSON](https://libtmux.org/en/ts/latest/mcp/tools/list_windows.json) · [Source](https://github.com/libtmux/libtmux-ts/blob/b3f338c1a21e614ebf0dd6d55aa36a60db816618/packages/mcp/src/tools/discovery.ts#L105)

## Arguments

* `session` optional · string

  Session id ($1) or name. Omit for all sessions.

## Schemas

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

Input schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "session": {
      "description": "Session id ($1) or name. Omit for all sessions.",
      "type": "string"
    }
  },
  "type": "object"
}
```

Output schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "complete": {
      "type": "boolean"
    },
    "omittedEntries": {
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "type": "integer"
    },
    "windows": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "Stable window id, e.g. @1.",
            "pattern": "^@\\d+$",
            "type": "string"
          },
          "layout": {
            "description": "tmux's observed saved layout, including any resizing or pruning; feed it back only when metadataComplete is true.",
            "type": "string"
          },
          "metadataComplete": {
            "description": "Whether every projected metadata string is complete.",
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "omittedMetadataBytes": {
            "description": "UTF-8 bytes omitted from projected metadata strings.",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "omittedPlacements": {
            "description": "Later placements omitted.",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "panes": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "placements": {
            "description": "Retained sessions and indexes where this window is linked.",
            "items": {
              "additionalProperties": false,
              "properties": {
                "active": {
                  "description": "Whether this placement is current in its session.",
                  "type": "boolean"
                },
                "index": {
                  "description": "The window index in this session.",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "sessionId": {
                  "description": "Stable session id, e.g. $1.",
                  "pattern": "^\\$\\d+$",
                  "type": "string"
                },
                "sessionName": {
                  "type": "string"
                }
              },
              "required": [
                "index",
                "sessionId",
                "sessionName",
                "active"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "placementsComplete": {
            "description": "Whether placements contains every placement.",
            "type": "boolean"
          },
          "zoomed": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "layout",
          "metadataComplete",
          "name",
          "omittedMetadataBytes",
          "panes",
          "omittedPlacements",
          "placements",
          "placementsComplete",
          "zoomed"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "complete",
    "omittedEntries",
    "windows"
  ],
  "type": "object"
}
```

Tool annotations

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