load_buffer

Python

Python
Ruby Unavailable
Lua Unavailable
TypeScript Unavailable
Rust Unavailable
Go Unavailable
Java Unavailable
.NET Unavailable
C++ Unavailable
Swift Unavailable

Load text into a new agent-namespaced tmux paste buffer.

Each call allocates a fresh buffer name — two concurrent calls will land in distinct buffers even if they pass the same logical_name. Agents MUST use the returned :attr:~libtmux_mcp.models.BufferRef.buffer_name on subsequent paste/show/delete calls.

When to use this vs. paste_text: load_buffer is the stage-then-fire path — you get a handle back and can inspect via show_buffer, paste into multiple panes via paste_buffer, or hold the content for later. Use paste_text for a simple one-shot paste with no follow-up.

All Python tools · JSON · Source

Arguments

content required · string: The text to stage. Can be multi-line. Redacted in audit logs.
logical_name optional: Short label for the buffer. Limited to ``[A-Za-z0-9_.-]{1,64}`` so the final name stays safe on the tmux command line. Empty or ``None`` uses ``"buf"``.
Default: null.
socket_name optional: tmux socket name.
Default: null.

Schemas

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

Input schema

{
  "additionalProperties": false,
  "properties": {
    "content": {
      "description": "The text to stage. Can be multi-line. Redacted in audit logs.",
      "type": "string"
    },
    "logical_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Short label for the buffer. Limited to\n``[A-Za-z0-9_.-]{1,64}`` so the final name stays safe on the\ntmux command line. Empty or ``None`` uses ``\"buf\"``."
    },
    "socket_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "tmux socket name."
    }
  },
  "required": [
    "content"
  ],
  "type": "object"
}

Output schema

{
  "description": "Handle returned by :func:`~libtmux_mcp.tools.buffer_tools.load_buffer`.\n\nAgent-created tmux paste buffers are namespaced with a per-call UUID\nto avoid collisions on the server-global buffer namespace when\nconcurrent agents (or parallel tool calls from a single agent) are\nstaging content. Callers must use the ``buffer_name`` this model\ncarries on subsequent\n:func:`~libtmux_mcp.tools.buffer_tools.paste_buffer`,\n:func:`~libtmux_mcp.tools.buffer_tools.show_buffer`, and\n:func:`~libtmux_mcp.tools.buffer_tools.delete_buffer` calls.",
  "properties": {
    "buffer_name": {
      "description": "The actual tmux buffer name (with prefix and UUID nonce). Pass this back to paste_buffer/show_buffer/delete_buffer.",
      "type": "string"
    },
    "logical_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional logical name supplied by the caller, if any."
    }
  },
  "required": [
    "buffer_name"
  ],
  "type": "object"
}

Tool annotations

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