readme: how to add the tmux snippet, and what it changes

added by hand, at the end of the tmux config. it replaces status-right,
turns on focus-events, adds hooks at index 77 and a status-line click
binding (needs mouse on); changes apply at the next reload.

1 files changed, 21 insertions, 2 deletions

diff --git a/README.md b/README.md
index 41ad3f6..a0c4097 100644
--- a/README.md
+++ b/README.md
@@ -135,8 +135,27 @@ swiftc -O -o target/dingger-menu menubar/*.swift    # menu bar + panel, bundled
 - launchd agents (start at login, restart on exit):
   `packaging/launchd/dev.dingger.{dingger,menubar}.plist`; adjust the user
   path, copy to `~/Library/LaunchAgents/`, `launchctl bootstrap gui/$(id -u) <plist>`.
-- tmux: `source-file /path/to/dingger/packaging/tmux/dingger.tmux` (needs
-  `set -g mouse on` for the click).
+- tmux: you add the snippet yourself; no `dingger install` command does it.
+  Put this line at the end of your tmux config (`~/.tmux.conf`, or a file
+  it sources):
+
+  ```tmux
+  source-file /path/to/dingger/packaging/tmux/dingger.tmux
+  ```
+
+  Then reload: `tmux source-file ~/.tmux.conf`. The snippet:
+  - **replaces** `status-right` with the restore offer, `%d-%b %H:%M`, and
+    the agent counts. Your own `status-right` is lost, so put the line after
+    it, or edit the snippet's `status-right` to keep what you had;
+  - turns on `focus-events`, which raising the right Ghostty window needs;
+  - adds hooks that report focus and navigation to dingger. They use index
+    `[77]`, so they keep your own hooks on the same events, and reloading
+    does not duplicate them;
+  - binds clicks on the right of the status line, which needs
+    `set -g mouse on`.
+
+  The line sources the snippet from the repo, so a changed snippet applies
+  at the next reload.
 
 dingger does not need tmux running first; it attaches when a server appears.