# wait_for_text

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

> Discount this server's pending input and recent submitted echoes; unmodelled keys stop tracking the current line. Wait for a new shell's prompt before typing. `matched_at_entry` reports visible text at entry; a mode ending in -unconfirmed identifies input that was still unconfirmed at the deadline. 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.

Discount this server’s pending input and recent submitted echoes; unmodelled keys stop tracking the current line. Wait for a new shell’s prompt before typing. `matched_at_entry` reports visible text at entry; a mode ending in -unconfirmed identifies input that was still unconfirmed at the deadline. Read pane output; accepts no client-supplied executable input. Returned content may be sensitive or untrusted.

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

## Arguments

* `target` required · string

  Pane ID or pane target.

* `text` required · string

  Literal text to wait for.

* `timeout_ms` optional · integer

  Bounded wait in milliseconds.

## Schemas

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