libtmux_mcp.tools.pane_tools.paste_text

API reference · Markdown

libtmux_mcp.tools.pane_tools.paste_text ( text : str , pane_id : str | None = None , bracket : bool = True , session_name : str | None = None , session_id : str | None = None , window_id : str | None = None , socket_name : str | None = None ) → str

function [source] ¶

function [source] ¶

libtmux_mcp.tools.pane_tools.paste_text

Paste multi-line text into a pane using tmux paste buffers.

Uses tmux's load-buffer and paste-buffer for clean multi-line input, avoiding the issues of sending text line-by-line via send_keys. Supports bracketed paste mode for terminals that handle it.

When to use this vs. load_buffer + paste_buffer: paste_text is the fire-and-forget path — the buffer is created, pasted, and deleted in one call. Use load_buffer + paste_buffer when you need to stage content first, paste it into multiple panes, or inspect it with show_buffer before pasting.

Parameters

• text ( str ) – The text to paste.

• pane_id ( str | None ) – Pane ID (e.g. '%1').

• bracket ( bool ) – Whether to use bracketed paste mode. Default True. Bracketed paste wraps the text in escape sequences that tell the terminal "this is pasted text, not typed input".

• session_name ( str | None ) – Session name for pane resolution.

• session_id ( str | None ) – Session ID for pane resolution.

• window_id ( str | None ) – Window ID for pane resolution.

• socket_name ( str | None ) – tmux socket name.

Returns

str Confirmation message.