# run_shell_command

Source: https://libtmux.org/en/java/latest/mcp/tools/run_shell_command/

> Runs one authored command in a trusted pane shell and waits for singular framed output and completion. Its two preflights refuse caller or attended panes and an effective cohort larger than one. Pre-existing exact-client-path, trap, eval, or exit functions are outside the supported boundary; marker display-message commands honor the trusted server's command aliases and hooks. Run a shell command in a pane with your user's permissions.

MCP is in development

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

Runs one authored command in a trusted pane shell and waits for singular framed output and completion. Its two preflights refuse caller or attended panes and an effective cohort larger than one. Pre-existing exact-client-path, trap, eval, or exit functions are outside the supported boundary; marker display-message commands honor the trusted server’s command aliases and hooks. Run a shell command in a pane with your user’s permissions.

[All Java tools](../) · [JSON](../run_shell_command.json) · [Source](https://github.com/libtmux/libtmux-java/blob/842228310449e879ebcaa3f910597757c9dbffd6/libtmux-mcp/src/main/java/io/github/libtmux/mcp/Catalog.java#L778)

## Arguments

* `command` required · string

  The shell command, run in the pane's interactive shell.

* `max_lines` optional · integer

  Maximum output lines, keeping the newest. Defaults to 200.

  Default: `200`.

* `pane_id` required · string

  The pane to act on, such as %1. Every listing tool returns these.

* `suppress_history` optional · boolean

  Best-effort persistent history suppression. Defaults to true.

  Default: `true`.

* `timeout` optional · number

  Seconds to wait before giving up. Defaults to 30.0.

  Default: `30`.

## Schemas

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