# libtmux_mcp.models.BufferRef

- **Module:** libtmux_mcp.models
- **Package:** libtmux-mcp
- **Language:** Python
- **Kind:** class
- **Source:** https://github.com/tmux-python/libtmux-mcp/blob/4daddc0dfca96c43bf521d818bf91564e1434760/src/libtmux_mcp/models.py#L707
- **Bases:** `BaseModel`
- **Page:** https://libtmux.org/en/py/stable/mcp/reference/libtmux_mcp-models-bufferref/

Handle returned by :func:`~libtmux_mcp.tools.buffer_tools.load_buffer`.

Agent-created tmux paste buffers are namespaced with a per-call UUID
to avoid collisions on the server-global buffer namespace when
concurrent agents (or parallel tool calls from a single agent) are
staging content. Callers must use the [`buffer_name`](/en/tmux/latest/catalog/formats/buffer_name/) this model
carries on subsequent
:func:`~libtmux_mcp.tools.buffer_tools.paste_buffer`,
:func:`~libtmux_mcp.tools.buffer_tools.show_buffer`, and
:func:`~libtmux_mcp.tools.buffer_tools.delete_buffer` calls.

## Members

### Other members

- [`buffer_name`](/en/py/stable/mcp/reference/libtmux_mcp-models-bufferref-buffer_name/) (attribute)
- [`logical_name`](/en/py/stable/mcp/reference/libtmux_mcp-models-bufferref-logical_name/) (attribute)