# search_panes

Source: https://libtmux.org/en/rs/latest/mcp/tools/search_panes/

> Search what panes are displaying with Rust's linear-time regex engine. Accept at most 4,096 pattern bytes; search at most 64 panes, 8,192 lines, and 1 MiB; spend at most 250 ms matching and five seconds capturing. Report the pane and line of every match. Use this to find where something is -- which pane has the failing test, which one printed the error -- instead of capturing panes one at a time. Searches the visible screen by default; set history to include scrollback. Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted.

MCP is in development

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

Search what panes are displaying with Rust’s linear-time regex engine. Accept at most 4,096 pattern bytes; search at most 64 panes, 8,192 lines, and 1 MiB; spend at most 250 ms matching and five seconds capturing. Report the pane and line of every match. Use this to find where something is — which pane has the failing test, which one printed the error — instead of capturing panes one at a time. Searches the visible screen by default; set history to include scrollback. Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted.

[All Rust tools](../) · [JSON](../search_panes.json) · [Source](https://github.com/libtmux/libtmux-rs/blob/f0e37052c232636b61d095817046e6bfc8f2ca40/crates/tmux-mcp/src/tools/inspect.rs#L344)

## Arguments

* `history` optional · boolean

  Search scrollback as well as the visible screen.

  Default: `false`.

* `match_case` optional · boolean

  Match case. Off by default.

  Default: `false`.

* `pattern` required · string

  The text to look for.

* `regex` optional · boolean

  Read the pattern as a regular expression rather than literal text.

  Default: `false`.

* `session` optional · string | null

  Only search panes in this session, by \`$\`-prefixed id or name. Omit for every session.

* `window` optional · string | null

  Only search panes in this window, by \`@\`-prefixed id. Omit for every window.

## Schemas

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