From 88103657fb230bb41217a06aa5602ae23e7acb8b Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Wed, 17 Sep 2025 21:33:45 +0300
Subject: =?UTF-8?q?feat(stats,tmux):=20global=20=CE=A3@window=20stats=20ac?=
 =?UTF-8?q?ross=20processes=20with=20flocked=20cache;=20width=20mitigation?=
 =?UTF-8?q?=20(narrow/maxlen);=20configurable=20[stats]=20window=5Fminutes?=
 =?UTF-8?q?;=20robust=20coverage=20parsing;=20docs=20update\n\n-=20Add=20i?=
 =?UTF-8?q?nternal/stats=20with=20windowed=20event=20cache=20+=20flock=20+?=
 =?UTF-8?q?=20atomic=20writes\n-=20Wire=20stats=20into=20LSP/CLI/Tmux=20Ac?=
 =?UTF-8?q?tion;=20tmux=20shows=20=CE=A3@window=20with=20per-model=20tail\?=
 =?UTF-8?q?n-=20HEXAI=5FTMUX=5FSTATUS=5FNARROW=20and=20HEXAI=5FTMUX=5FSTAT?=
 =?UTF-8?q?US=5FMAXLEN=20for=20width=20control\n-=20Add=20[stats]=20window?=
 =?UTF-8?q?=5Fminutes=20to=20config=20and=20apply=20on=20startup\n-=20Impr?=
 =?UTF-8?q?ove=20Magefile=20coverage=20handling;=20add=20tests=20to=20lift?=
 =?UTF-8?q?=20coverage=20>85%\n-=20Update=20docs/tmux.md=20and=20config=20?=
 =?UTF-8?q?example?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/tmux.md | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

(limited to 'docs/tmux.md')

diff --git a/docs/tmux.md b/docs/tmux.md
index dd7ceb5..01d741e 100644
--- a/docs/tmux.md
+++ b/docs/tmux.md
@@ -39,6 +39,11 @@ set-environment -g HEXAI_TMUX_STATUS_THEME white-on-purple   # or black-on-yello
 # Or explicit colors
 # set-environment -g HEXAI_TMUX_STATUS_FG white
 # set-environment -g HEXAI_TMUX_STATUS_BG magenta
+
+# Optional: narrow / width-limited mode
+# Only show Σ (global) when narrow; or cap total width when long
+# set-environment -g HEXAI_TMUX_STATUS_NARROW 1
+# set-environment -g HEXAI_TMUX_STATUS_MAXLEN 40
 ```
 
 ## Use it
@@ -47,4 +52,17 @@ set-environment -g HEXAI_TMUX_STATUS_THEME white-on-purple   # or black-on-yello
 - Try completions or inline prompts; or select code and press Alt-a for the action menu.
 - Watch the right side of your tmux status for live LLM stats:
   - Start heartbeat: provider:model ⏳
-  - Stats: ↑sent ↓recv rpm reqs
+  - Global stats (Σ@window): ↑sent ↓recv rpm reqs
+  - Per-model tail is elided in narrow mode or when exceeding `HEXAI_TMUX_STATUS_MAXLEN`.
+
+## Global stats window
+
+- Hexai aggregates stats across all binaries and shows a global Σ view over a sliding window.
+- Configure the window in `~/.config/hexai/config.toml`:
+
+```
+[stats]
+window_minutes = 60  # default 60; min 1, max 1440
+```
+
+- The tmux status shows the window as `Σ@1h` or `Σ@45m`.
-- 
cgit v1.2.3