# wait_for_text

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

> Waits for new pane output without accepting executable input. Discounts recognized input from this server while pending and for ten seconds after submission. Output identical to that input and partially redrawn echoes are ambiguous; use run_shell_command for commands you start. Wait for the prompt before typing into a cold shell. 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.

Waits for new pane output without accepting executable input. Discounts recognized input from this server while pending and for ten seconds after submission. Output identical to that input and partially redrawn echoes are ambiguous; use [run\_shell\_command](https://libtmux.org/en/java/latest/mcp/tools/run_shell_command/) for commands you start. Wait for the prompt before typing into a cold shell. Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted.

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

## Arguments

* `cursor` optional · string

  A cursor returned by an earlier capture.

* `max_lines` optional · integer

  Maximum observed lines to return. Defaults to 200.

  Default: `200`.

* `pane_id` required · string

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

* `patterns` optional · array | string

  Text to wait for; any one ends the wait. One value may be sent on its own, without a list.

* `regex` optional · boolean

  Treat patterns and stops as regular expressions. Defaults to false.

  Default: `false`.

* `stop` optional · array | string

  Failure text; any one ends the wait. One value may be sent on its own, without a list.

* `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.