Wait for content change¶
wait_for_content_change¶
Wait for any content change in a tmux pane.
- Returns:
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 |
|---|---|---|---|---|
|
no |
— |
Pane ID (e.g. ‘%1’). |
|
|
no |
— |
Session name for pane resolution. |
|
|
no |
— |
Session ID (e.g. ‘$1’) for pane resolution. |
|
|
no |
— |
Window ID for pane resolution. |
|
|
no |
|
Maximum seconds to wait. Default 8.0. |
|
|
no |
|
Seconds between polls. Default 0.05 (50ms). |
|
|
no |
— |
tmux socket name. |
|
|
Context |
no |
— |
FastMCP context for progress notifications. Omitted in tests. |