Wait for content change

wait_for_content_change

wait_for_content_change
readonly tool
readonly tool
wait_for_content_change

Wait for any content change in a tmux pane.

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. Raises an ExpectedToolError if the pane dies or is respawned while waiting, because the entry content baseline no longer describes the same pane process.

Example:

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

Response:

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

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.