diff options
Diffstat (limited to 'docs/helix-tmux-quickstart.md')
| -rw-r--r-- | docs/helix-tmux-quickstart.md | 68 |
1 files changed, 0 insertions, 68 deletions
diff --git a/docs/helix-tmux-quickstart.md b/docs/helix-tmux-quickstart.md deleted file mode 100644 index caee3f8..0000000 --- a/docs/helix-tmux-quickstart.md +++ /dev/null @@ -1,68 +0,0 @@ -# Helix + tmux Quickstart - -This guide gets you from zero to editing with Hexai in Helix, with tmux showing live LLM status. - -## 1) Install - -- Install Mage (optional for build tasks): `go install github.com/magefile/mage@latest` -- Install binaries directly: - - CLI: `go install codeberg.org/snonux/hexai/cmd/hexai@latest` - - LSP: `go install codeberg.org/snonux/hexai/cmd/hexai-lsp@latest` - - TUI: `go install codeberg.org/snonux/hexai/cmd/hexai-tmux-action@latest` - -Ensure `~/go/bin` is on your `PATH`. - -## 2) Configure Helix - -In `~/.config/helix/languages.toml`: - -```toml -[[language]] -name = "go" -auto-format = true -language-servers = ["gopls", "hexai"] - -[language-server.hexai] -command = "hexai-lsp" -``` - -Optional keybindings in `~/.config/helix/config.toml` to run code actions on the selection: - -```toml -[keys.select] -"A-a" = ":pipe hexai-tmux-action" - -[keys.normal] -"A-a" = ["select_line", ":pipe hexai-tmux-action"] -``` - -## 3) Configure tmux status - -Add this to `~/.tmux.conf` and reload with `tmux source-file ~/.tmux.conf`: - -``` -set -g status-right '#{@hexai_status} #[fg=colour8]| %H:%M' -set -g status-right-length 120 - -# Optional: theme the Hexai status segment -set-environment -g HEXAI_TMUX_STATUS_THEME white-on-purple # or black-on-yellow, white-on-blue -# Or explicit colors -# set-environment -g HEXAI_TMUX_STATUS_FG white -# set-environment -g HEXAI_TMUX_STATUS_BG magenta -``` - -## 4) Use it - -- Start tmux, open Helix on a Go file. -- 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 - -## 5) Troubleshooting - -- No status? Verify: `tmux show -g -v @hexai_status` (should show text). -- Truncated? Increase width: `set -g status-right-length 120`. -- Disabled? Ensure `HEXAI_TMUX_STATUS` is not set to `0`. -- Wrong model? Rebuild/update binaries and restart Helix/LSP. - |
