docs(README) Overhaul README

CHANGES

@@ -894,6 +894,18 @@ libtmux 0.46.1 is a maintenance release for the 0.46.x line.
 The {meth}`~libtmux.Pane.send_keys` documentation had a typo fixed. Thanks
 @subbyte.
 
+### New features
+
+#### Waiting (#582)
+
+Added experimental `waiter.py` module for polling for terminal content in tmux panes:
+
+- Fluent API inspired by Playwright for better readability and chainable options
+- Support for multiple pattern types (exact text, contains, regex, custom predicates)
+- Composable waiting conditions with `wait_for_any_content` and `wait_for_all_content`
+- Enhanced error handling with detailed timeouts and match information
+- Robust shell prompt detection
+
 ## libtmux 0.46.0 (2025-02-25)
 
 libtmux 0.46.0 finishes the `libtmux.test` helper split by removing root-level