resize_pane

Change tmux state; no client-supplied executable input. Resize a pane, either to a size or by an amount in a direction. Give width/height for an absolute size, or direction with amount for a nudge.

All TypeScript tools · JSON · Source

Arguments

amount optional · integer: Cells to move by. Needs direction.
direction optional · string: Adjust by an amount in this direction instead of setting a size.
height optional · integer: Set the pane height, in rows.
paneId required · string: Stable pane id, e.g. %1.
width optional · integer: Set the width, in columns.
zoom optional · boolean: true makes this pane fill its window, false restores the layout. A state, not a toggle: sending the same value twice is a no-op.

Schemas

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

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "amount": {
      "description": "Cells to move by. Needs direction.",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "type": "integer"
    },
    "direction": {
      "description": "Adjust by an amount in this direction instead of setting a size.",
      "enum": [
        "up",
        "down",
        "left",
        "right"
      ],
      "type": "string"
    },
    "height": {
      "description": "Set the pane height, in rows.",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "type": "integer"
    },
    "paneId": {
      "description": "Stable pane id, e.g. %1.",
      "pattern": "^%\\d+$",
      "type": "string"
    },
    "width": {
      "description": "Set the width, in columns.",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "type": "integer"
    },
    "zoom": {
      "description": "true makes this pane fill its window, false restores the layout. A state, not a toggle: sending the same value twice is a no-op.",
      "type": "boolean"
    }
  },
  "required": [
    "paneId"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "pane": {
      "additionalProperties": false,
      "properties": {
        "active": {
          "description": "Whether this is its window's active pane.",
          "type": "boolean"
        },
        "command": {
          "description": "The command tmux reports running in it.",
          "type": "string"
        },
        "cwd": {
          "description": "Its current working directory.",
          "type": "string"
        },
        "dead": {
          "description": "Whether its process exited and remain-on-exit kept it.",
          "type": "boolean"
        },
        "height": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        },
        "id": {
          "description": "Stable pane id. Prefer this for entity-scoped targeting.",
          "pattern": "^%\\d+$",
          "type": "string"
        },
        "index": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        },
        "isAttended": {
          "description": "A person is currently looking at this pane.",
          "type": "boolean"
        },
        "isCallerPane": {
          "description": "This is the pane this MCP server runs in.",
          "type": "boolean"
        },
        "metadataComplete": {
          "description": "Whether every projected metadata string is complete.",
          "type": "boolean"
        },
        "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"
        },
        "placements": {
          "description": "Retained session and window indexes through which this pane is reachable.",
          "items": {
            "additionalProperties": false,
            "properties": {
              "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"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "placementsComplete": {
          "description": "Whether placements contains every placement.",
          "type": "boolean"
        },
        "title": {
          "type": "string"
        },
        "width": {
          "maximum": 9007199254740991,
          "minimum": -9007199254740991,
          "type": "integer"
        },
        "windowId": {
          "description": "Stable window id, e.g. @1.",
          "pattern": "^@\\d+$",
          "type": "string"
        },
        "windowName": {
          "type": "string"
        }
      },
      "required": [
        "active",
        "command",
        "cwd",
        "dead",
        "height",
        "id",
        "index",
        "isAttended",
        "isCallerPane",
        "metadataComplete",
        "omittedMetadataBytes",
        "omittedPlacements",
        "placements",
        "placementsComplete",
        "title",
        "width",
        "windowId",
        "windowName"
      ],
      "type": "object"
    }
  },
  "required": [
    "pane"
  ],
  "type": "object"
}

Tool annotations

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

Scripting & web

Compiled & native

JVM

.NET

tmux

resize_pane

Arguments

Schemas