summaryrefslogtreecommitdiff
path: root/docs/configuration.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2025-09-08 09:50:38 +0300
committerPaul Buetow <paul@buetow.org>2025-09-08 09:50:38 +0300
commitcead3ebde8f3aee0ef8677158d37f4d04c6629dc (patch)
treeeadf4928c13e4f1fd782e8e0955116a24cef1d27 /docs/configuration.md
parent29b0da31acf02816ee9e8f1d5a1b9a0ad5993593 (diff)
tmux: colored LLM status with provider + stats; add start heartbeat for LSP/CLI/TUI; theme support via HEXAI_TMUX_STATUS_THEME and HEXAI_TMUX_STATUS_FG/BG; docs: update tmux options and add Helix+tmux quickstart
Diffstat (limited to 'docs/configuration.md')
-rw-r--r--docs/configuration.md12
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/configuration.md b/docs/configuration.md
index 690a08f..95b65de 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -69,14 +69,20 @@ Tmux status line
- `set -g status-right '#{@hexai_status} #[fg=colour8]| %H:%M'`
- Status content is updated best‑effort at key moments:
- - CLI: start (⏳ provider:model) and completion (✅ model duration)
- - LSP: after logging aggregate LLM stats (LLM:model)
- - TUI action runner: ready (model) and completion (✅ model)
+ - CLI: start (⏳ provider:model) and completion with compact stats (↑sent, ↓recv, rpm, reqs)
+ - LSP: initial heartbeat on client initialize, and periodic compact stats (provider, model, rpm, reqs, bytes)
+ - TUI action runner: ready (provider:model) and completion with compact stats
- Toggle via environment:
- Enable (default): unset or `HEXAI_TMUX_STATUS=1`
- Disable: `HEXAI_TMUX_STATUS=0`
+- Theme and colors:
+ - Preset: `HEXAI_TMUX_STATUS_THEME=white-on-purple` (white fg on purple/magenta bg)
+ - Explicit: `HEXAI_TMUX_STATUS_FG=<color>`, `HEXAI_TMUX_STATUS_BG=<color>` (e.g., `white`, `magenta`, `colour5`)
+ - Colors use tmux’s `fg`/`bg` names; both methods wrap the entire `@hexai_status` segment.
+ - If truncated, increase width: `set -g status-right-length 120`
+
Code action prompts
- All prompts can be customized under `[prompts.code_action]` in `config.toml`. In addition to `rewrite_*`, `diagnostics_*`, `document_*`, and `go_test_*`, the following templates control the “Simplify and improve” action: