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.
Igor Soarez igor@soarez.org
Sun, 25 Oct 2026 20:58:35 +0200
1 files changed,
21 insertions(+),
2 deletions(-)
jump to
M
README.md
→
README.md
@@ -135,8 +135,27 @@
- 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.