feat(stats,tmux): global Σ@window stats across processes with flocked cache; width mitigation (narrow/maxlen); configurable [stats] window_minutes; robust coverage parsing; docs update\n\n- Add internal/stats with windowed event cache + flock + atomic writes\n- Wire stats into LSP/CLI/Tmux Action; tmux shows Σ@window with per-model tail\n- HEXAI_TMUX_STATUS_NARROW and HEXAI_TMUX_STATUS_MAXLEN for width control\n- Add [stats] window_minutes to config and apply on startup\n- Improve Magefile coverage handling; add tests to lift coverage >85%\n- Update docs/tmux.md and config example

1 files changed, 19 insertions, 1 deletions

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`.