# tmux_run

Source: https://libtmux.org/en/ruby/latest/mcp/tools/tmux_run/

> Run an authored POSIX script in an explicitly enrolled idle, empty zsh 5.9 editor. Opt-in; no terminal injection. Exact queue authorization binds the existing shell generation; execution may follow a later pane replacement without retargeting it. Inherits cwd/exported environment, closed stdin, separate bounded UTF-8/base64 outputs. Defaults: 65536 bytes per output, 65536 script bytes; overflow refuses completion. Reports native exit/signal only from the helper; cancellation never proves descendants stopped.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

Run an authored POSIX script in an explicitly enrolled idle, empty zsh 5.9 editor. Opt-in; no terminal injection. Exact queue authorization binds the existing shell generation; execution may follow a later pane replacement without retargeting it. Inherits cwd/exported environment, closed stdin, separate bounded UTF-8/base64 outputs. Defaults: 65536 bytes per output, 65536 script bytes; overflow refuses completion. Reports native exit/signal only from the helper; cancellation never proves descendants stopped.

**Policy:** opt in with --enable-tool tmux\_run.

[All Ruby tools](../) · [JSON](../tmux_run.json) · [Source](https://github.com/libtmux/libtmux-ruby/blob/e3815d2b35a6c663f20769231e1d22b565f87038/gems/libtmux-mcp/lib/libtmux/mcp/catalog.rb#L237)

## Arguments

* `script` required · string

  See the schema for this argument’s constraints.

* `stderr_limit` optional · integer

  See the schema for this argument’s constraints.

* `stdout_limit` optional · integer

  See the schema for this argument’s constraints.

* `target` required

  See the schema for this argument’s constraints.

## Schemas

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