Developer Tooling

Helix + Byobu on macOS

A practical reference for getting comfortable in Helix editor running inside Byobu — covering keybindings, multiple cursors, LSP, Byobu pane management, clipboard, and all the macOS-specific gotchas.

macOS Setup

F-keys getting intercepted by macOS

By default macOS maps F-keys to brightness, volume, and Mission Control — which breaks Byobu's entire interface. Fix it one of two ways:

• System-wide: System Settings → Keyboard → enable "Use F1, F2, etc. keys as standard function keys". You can still trigger media actions with Fn + F-key.
• iTerm2 (recommended): iTerm2 intercepts F-keys before macOS and passes them straight to the terminal. No system setting change needed. Prefer iTerm2 over Terminal.app for this setup.

Option key as Alt

Helix uses Alt combos heavily (e.g. Alt-C for multiple cursors). The Option key needs to emit escape sequences, not Unicode characters:

• Terminal.app: Preferences → Profiles → Keyboard → ✅ Use Option as Meta key
• iTerm2: Preferences → Profiles → Keys → Left Option key → Esc+

Byobu Essentials

Byobu wraps tmux. Its primary interface uses F-keys, which almost never conflict with Helix.

Sessions & Windows

Panes

Scrollback

Use F7 to enter tmux scroll mode — navigate with arrow keys or PgUp/PgDn, exit with q or Enter. Only use this for scrolling terminal output outside Helix. Inside Helix, use Ctrl-d / Ctrl-u instead.

Helix Core Concepts

Helix is selection-first, unlike Vim's operator-first model. You select something, then act on it.

Vim:    d w    →  operator (delete) then motion (word)
Helix:  w d    →  select word, then delete selection

Navigation

Selection & Multiple Cursors

Multiple cursors are a first-class feature in Helix — no plugin needed.

Editing

Surround operations

Search & Jump

File & Buffer Management

Window Splits (inside Helix)

Helix has its own split system independent of Byobu panes. Use Helix splits to view two files side by side; use Byobu panes to run a shell alongside your editor.

LSP & Code Intelligence

LSP is built in — no plugins. Install the language server for your language (e.g. brew install rust-analyzer, npm i -g typescript-language-server) and Helix picks it up automatically.

Productivity Tips

Repeat f/t motions

After pressing f<char> or t<char>, press ; to repeat the motion forward or , to repeat backward. Much faster than retyping.

Text object selections

Press m then i (inside) or a (around) followed by a delimiter. Examples: mi( selects inside parentheses, maw selects around a word including surrounding whitespace, mi" selects inside quotes.

Jump to any visible line

Use relative line numbers (see config below) combined with g<number> to jump anywhere on screen instantly — no counting from the top.

Shell in an adjacent Byobu pane

Press Ctrl-F2 to create a vertical pane. Run your build/test/git there. Shift-← to return to Helix. This flow keeps you from losing Helix context just to run a command.

Recommended Config (~/.config/helix/config.toml)

[editor]
line-number = "relative"      # jump anywhere with g<number>
scrolloff = 8                 # keep cursor away from screen edges
cursorline = true             # highlight current line
color-modes = true            # mode indicator changes color
mouse = true                  # click to move cursor

[editor.statusline]
left  = ["mode", "spinner", "file-name", "file-modification-indicator"]
right = ["diagnostics", "position", "file-encoding", "file-type"]

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

[keys.normal]
";" = "repeat_last_motion"    # repeat last f/t/F/T

Helix vs Vim: Mental Model

The hardest adjustment coming from Vim is remembering the order is reversed: select then act.