1 files changed, 16 insertions, 0 deletions
diff --git a/README.md b/README.md
index c735aa8..7ba1514 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,22 @@ format:
 OSC 9 ; [message] ST
 ```
 
+Clicking the notification brings Tabby to the front and switches to the exact
+tab/pane that emitted the sequence. The notification title reflects the tab's
+current title at the time the sequence is received.
+
+The OSC 9 title is cleaned up: it prefers a user-set custom tab name, and when
+the title looks like a filesystem path (e.g. a shell tab showing its cwd) only
+the last path segment is used instead of the full, often-truncated path.
+
+`OSC 777 ; notify ; title ; body` (the rxvt/urxvt notification form) is also
+supported, letting a program set an explicit title and body:
+
+```sh
+# creates a notification titled 'Build' with body 'Done'
+printf "\033]777;notify;Build;Done\a"
+```
+
 ### Example commands
 
 ```sh