libtmux_mcp.tools.pane_tools.send_keys_batch

API reference · Markdown

libtmux_mcp.tools.pane_tools.send_keys_batch ( operations : list[SendKeysOperation] , on_error : t.Literal["stop", "continue"] = "stop" , timeout : float | None = None , socket_name : str | None = None ) → SendKeysBatchResult

function [source] ¶

function [source] ¶

libtmux_mcp.tools.pane_tools.send_keys_batch

Send an ordered batch of raw key/text operations to tmux panes.

Use this for bulk TUI or persistent-shell input where each item is the same kind of low-level terminal interaction as send_keys . For authored shell commands that need exit status and captured output, use run_command instead. For repeated observation after sending input, use capture_since with its returned cursor.

This tool intentionally does not compose heterogeneous operations such as send → wait → capture. Keeping the batch homogeneous preserves clear per-operation error attribution and avoids embedding a workflow DSL in the MCP tool surface.

Parameters

• operations ( list[SendKeysOperation] ) – Ordered raw-input operations to send.

• on_error ( t.Literal["stop", "continue"] ) – Whether to stop at the first failed operation or keep attempting later operations. Default "stop".

• timeout ( float | None ) – Maximum time in seconds to allow the batch to run before aborting.

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

Returns

SendKeysBatchResult Per-operation results with success/error counts and stop index.