Helix

# macOS (Homebrew)
brew install helix

# Ubuntu/Debian (official PPA or binary)
sudo add-apt-repository ppa:maveonair/helix-editor
sudo apt update
sudo apt install helix

# Fedora
sudo dnf install helix

# Arch Linux
sudo pacman -S helix

# Install via Cargo (Rust)
cargo install helix-term --locked

# AppImage
curl -LO https://github.com/helix-editor/helix/releases/latest/download/helix-*.AppImage
chmod +x helix-*.AppImage

# Check version
hx --version

# Health check (verify LSP and Tree-sitter status)
hx --health

# Open a file
hx filename.txt

# Open multiple files
hx file1.txt file2.txt

# Open directory (file picker)
hx .

# Open and jump to specific line
hx filename.txt:10

# Open tutorial
hx --tutor

# Check configuration file location
hx --health

# Theme settings
theme = "catppuccin_mocha"

[editor]
# Line numbers
line-number = "relative"
# Cursor shape
cursorline = true
# Mouse support
mouse = true
# Auto-save
auto-save = true
# True Color
true-color = true
# Colored mode indicator
color-modes = true
# Buffer line
bufferline = "multiple"
# Idle timeout
idle-timeout = 50

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[editor.statusline]
left = ["mode", "spinner", "file-name", "file-modification-indicator"]
center = []
right = ["diagnostics", "selections", "position", "file-encoding", "file-type"]
separator = "│"
mode.normal = "NORMAL"
mode.insert = "INSERT"
mode.select = "SELECT"

[editor.lsp]
display-messages = true
display-inlay-hints = true

[editor.indent-guides]
render = true
character = "│"
skip-levels = 1

[editor.whitespace.render]
space = "none"
tab = "all"
newline = "none"

[editor.file-picker]
hidden = false

[editor.soft-wrap]
enable = true

# Key mappings
[keys.normal]
# Save
C-s = ":w"
# Save all
C-S-s = ":wa"
# Window navigation (Vim-style Ctrl+w)
C-h = "jump_view_left"
C-j = "jump_view_down"
C-k = "jump_view_up"
C-l = "jump_view_right"

[keys.insert]
# jk to enter Normal mode
j = { k = "normal_mode" }

[keys.select]
# jk to enter Normal mode in Select mode too
j = { k = "normal_mode" }

# Formatter settings
[[language]]
name = "rust"
auto-format = true

[[language]]
name = "python"
auto-format = true
formatter = { command = "black", args = ["-", "-q"] }

[[language]]
name = "javascript"
auto-format = true
formatter = { command = "prettier", args = ["--parser", "typescript"] }

[[language]]
name = "typescript"
auto-format = true
formatter = { command = "prettier", args = ["--parser", "typescript"] }

[[language]]
name = "json"
formatter = { command = "prettier", args = ["--parser", "json"] }

[[language]]
name = "markdown"
soft-wrap.enable = true

# LSP server settings
[language-server.typescript-language-server]
command = "typescript-language-server"
args = ["--stdio"]

[language-server.pyright]
command = "pyright-langserver"
args = ["--stdio"]

# Full health check
hx --health

# Language-specific health check
hx --health rust
hx --health python
hx --health typescript

# Install common LSP servers
# Rust
rustup component add rust-analyzer

# Python
pip install pyright
# or
npm install -g pyright

# TypeScript/JavaScript
npm install -g typescript-language-server typescript

# Go
go install golang.org/x/tools/gopls@latest

# Lua
brew install lua-language-server  # macOS