Wait for content change

wait_for_content_change

wait_for_content_change

readonly tool

Wait for any content change in a tmux pane.

Returns:

ContentChangeResult

Use when you’ve sent a command and need to wait for something to happen, but you don’t know what the output will look like. Unlike wait_for_text, this waits for any screen change rather than a specific pattern.

Avoid when you know the expected output — wait_for_text is more precise and avoids false positives from unrelated output.

Side effects: None. Readonly. Blocks until content changes or timeout.

Example:

{
  "tool": "wait_for_content_change",
  "arguments": {
    "pane_id": "%0",
    "timeout": 10
  }
}

Response:

{
  "changed": true,
  "pane_id": "%0",
  "elapsed_seconds": 1.234,
  "timed_out": false
}

Parameters

Parameter	Type	Required	Default	Description
pane_id	str	no	—	Pane ID (e.g. ‘%1’).
session_name	str	no	—	Session name for pane resolution.
session_id	str	no	—	Session ID (e.g. ‘$1’) for pane resolution.
window_id	str	no	—	Window ID for pane resolution.
timeout	float	no	8.0	Maximum seconds to wait. Default 8.0.
interval	float	no	0.05	Seconds between polls. Default 0.05 (50ms).
socket_name	str	no	—	tmux socket name.
ctx	Context	no	—	FastMCP context for progress notifications. Omitted in tests.