Buffer tools¶
tmux paste buffers are a server-global namespace shared by every client on the same socket. The buffer tools in libtmux-mcp expose a narrow, agent-namespaced subset: every allocation gets a UUID-scoped name like libtmux_mcp_<32-hex>_<logical>, so concurrent agents (or parallel tool calls from one agent) cannot collide on each other’s payloads.
There is no list_buffers tool. The user’s OS clipboard often syncs into tmux paste buffers, so a generic enumeration would leak passwords, tokens, and other private content the agent has no business reading. Callers track the buffers they own via the load_buffer mutating returns.
Stage content into a new tmux paste buffer.
Push a staged buffer into a pane.
Read a staged buffer’s contents back.
Free the server-side state of a staged buffer.