# run_shell_command

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

> Require one live configured pane, outside human-owned mode and running a supported POSIX foreground shell, then send one command and return output after its private completion boundary. 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.

Require one live configured pane, outside human-owned mode and running a supported POSIX foreground shell, then send one command and return output after its private completion boundary. Run a shell command in a pane with your user’s permissions.

[All C++ tools](../) · [JSON](../run_shell_command.json) · [Source](https://github.com/libtmux/libtmux-cxx/blob/393d4b0ad666f18a6581f1eb281741a75a7503f0/apps/mcp/src/tool_catalog.cpp#L2657)

## Arguments

* `command` required · string

  Shell command sent to the pane.

* `paneId` required · string

  Stable pane ID.

* `timeoutMs` optional · integer

  Completion timeout in milliseconds.

## Schemas

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