tool MCPlatest

`swap_pane`

swap_pane( otherPaneId: string, paneId: string, )

tool [source]¶

Change tmux state; no client-supplied executable input. Exchange two panes’ positions. Their ids and contents travel with them.

MCP request method: tools/call Send swap_pane as the tool name, with the arguments below.

Arguments#

otherPaneId (string) #

Stable pane id, e.g. %1.

pattern
"^%\\d+$"
paneId (string) #

Stable pane id, e.g. %1.

pattern
"^%\\d+$"

Result#

Returns object

complete (boolean) #
omittedEntries (integer) #

minimum
0
maximum
9007199254740991
panes (Array<object>) #
- Items (object) #
  - active (boolean) #
    
    Whether this is its window’s active pane.
  - command (string) #
    
    The command tmux reports running in it.
  - cwd (string) #
    
    Its current working directory.
  - dead (boolean) #
    
    Whether its process exited and remain-on-exit kept it.
  - height (integer) #
    
    minimum
    -9007199254740991
    maximum
    9007199254740991
  - id (string) #
    
    Stable pane id. Prefer this for entity-scoped targeting.
    
    pattern
    "^%\\d+$"
  - index (integer) #
    
    minimum
    -9007199254740991
    maximum
    9007199254740991
  - isAttended (boolean) #
    
    A person is currently looking at this pane.
  - isCallerPane (boolean) #
    
    This is the pane this MCP server runs in.
  - metadataComplete (boolean) #
    
    Whether every projected metadata string is complete.
  - omittedMetadataBytes (integer) #
    
    UTF-8 bytes omitted from projected metadata strings.
    
    minimum
    0
    maximum
    9007199254740991
  - omittedPlacements (integer) #
    
    Later placements omitted.
    
    minimum
    0
    maximum
    9007199254740991
  - placements (Array<object>) #
    
    Retained session and window indexes through which this pane is reachable.
    - Items (object) #
      - index (integer) #
        
        The window index in this session.
        
        minimum
        -9007199254740991
        maximum
        9007199254740991
      - sessionId (string) #
        
        Stable session id, e.g. $1.
        
        pattern
        "^\\$\\d+$"
      - sessionName (string) #
      No other properties are accepted.
  - placementsComplete (boolean) #
    
    Whether placements contains every placement.
  - title (string) #
  - width (integer) #
    
    minimum
    -9007199254740991
    maximum
    9007199254740991
  - windowId (string) #
    
    Stable window id, e.g. @1.
    
    pattern
    "^@\\d+$"
  - windowName (string) #
  No other properties are accepted.

No other properties are accepted.

Annotations#

destructiveHint: true
idempotentHint: false
openWorldHint: true
readOnlyHint: false

Protocol data#

Use the complete advertised contract for validation and client integration.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "otherPaneId": {
      "description": "Stable pane id, e.g. %1.",
      "pattern": "^%\\d+$",
      "type": "string"
    },
    "paneId": {
      "description": "Stable pane id, e.g. %1.",
      "pattern": "^%\\d+$",
      "type": "string"
    }
  },
  "required": [
    "otherPaneId",
    "paneId"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "complete": {
      "type": "boolean"
    },
    "omittedEntries": {
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    },
    "panes": {
      "items": {
        "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"
      },
      "type": "array"
    }
  },
  "required": [
    "complete",
    "omittedEntries",
    "panes"
  ],
  "type": "object"
}

Scripting & web

Compiled & native

JVM

.NET

BEAM

tmux

`swap_pane`

Arguments#

Result#

Annotations#

Protocol data#