Skip to content

v0.9.0

Choose a tag to compare

View all tags
@snonux snonux released this 07 Feb 19:48
· 423 commits to main since this release
v0.9.0
0dcf347

Release v0.9.0

Release Notes

Overview

This release brings powerful tmux status line integration across all Hexai interfaces (CLI, LSP, and the TUI action runner), providing real-time visual feedback on LLM provider, model, and live statistics. It introduces full theming options for tmux status, a new Helix+tmux quickstart, and usability refinements—making workflows with Hexai and terminal multiplexers smoother and more informative. Several improvements, doc enhancements, and minor bug fixes are included.

🚀 Features

tmux Status Line Integration

  • Live LLM Stats in tmux:
    Hexai now updates the @hexai_status tmux user option to show real-time LLM activity (provider, model, requests per minute, and data in/out).

    • CLI updates status at start and completion.
    • LSP posts a "heartbeat" on initialization and after LLM completions.
    • TUI (hexai-tmux-action) runner broadcasts heartbeats at start, ready, and on completion.

  • Configurable Theming:
    You can set status segment foreground/background colors via:

    • Preset themes: HEXAI_TMUX_STATUS_THEME=white-on-purple (or black-on-yellow, white-on-blue)
    • Explicit control: HEXAI_TMUX_STATUS_FG=white, HEXAI_TMUX_STATUS_BG=magenta
    • If your segment is truncated, increase length: 
      set -g status-right-length 120

  • Easy Setup:
    Add this to your .tmux.conf for immediate benefit:

    set -g status-right '#{@hexai_status} #[fg=colour8]| %H:%M'

  • Toggle Behavior:
    Status updates are on by default. Disable with HEXAI_TMUX_STATUS=0.

  • New documentation:

🛠 Improvements

  • User Experience

    • LLM stats in status line use human-friendly units (e.g., ↑12k ↓34k for bytes in/out).
    • CLI, TUI, and LSP coordinate to avoid clashing or redundant updates.
    • Colors are selected for high-contrast and theme compatibility.
    • Error and heartbeat messaging is informative but unobtrusive.

  • Docs, Examples, and Guides

    • Updated the README for tmux status integration and theming.
    • Added Helix keybinding and tmux setup walkthrough.
    • Improved docs/usage.md with practical keybindings and tips.
    • Provided troubleshooting steps if status doesn't appear as expected.

🐞 Bug Fixes & Quality

  • Ensured status updates are robust in all environments (do not error if tmux is absent or disabled).
  • Status is updated best‑effort and never blocks editor workflows.
  • Prevented status clobbering or visual artifacts in multi-session or theme-changed scenarios.

⚠️ Breaking Changes / Migration

  • None. All new features are opt-in and backward compatible.
  • To benefit from the tmux status line, simply update your .tmux.conf (see above) and ensure you are running Hexai in a tmux session.

📝 How to Upgrade

  1. Update your Hexai binaries (go install ... or via your preferred method).
  2. Add the recommended tmux line to your .tmux.conf and reload config.
  3. Set an optional theme if desired using the documented environment variables.
  4. Start a new tmux session and use Helix or run Hexai CLI/Action as usual.

💬 Feedback

This release lays the foundation for richer terminal/editor integration. If you have issues with tmux status visibility, color themes, or further integration ideas, please open a discussion or issue!

Enjoy streamlined, informative LLM workflows with Hexai and tmux!

Assets 2
Loading