Settings reference

Development reference · View source

Every setting below is also on the [config] page, except workspace.state, workspace.state_anchor, and the language-server definitions, which are file-only.

Editor settings

Setting	Default	Values	What it does
`editor.grammar`	`runyte`	`runyte` (`helix` is an alias)	Editing grammar. The alias is for compatibility, not a promise of full Helix behavior.
`editor.line_numbers`	`true`	boolean	Show line numbers beside editable buffers.
`editor.relative_line_numbers`	`false`	boolean	Show document-line distances from each pane’s cursor, keeping the cursor line absolute. Requires `editor.line_numbers`. Wrapped continuations keep their arrows; folded lines still count in distances.
`editor.tab_width`	`4`	1–16	Display and indentation width of a tab.
`editor.indent`	`spaces`	`spaces`, `tabs`	Style of new indentation. `Tab` inserts this style, `Shift-Tab` the other.
`editor.smart_newline`	`true`	boolean	Add syntax indentation and continue Markdown lists on a new line. `false` keeps only the leading indent.
`editor.auto_close`	`false`	boolean	Pair typed brackets and quotes in Insert mode.
`editor.scroll_offset`	`3`	0–100	Rows kept visible above and below the cursor.
`editor.motion_repeat_multiplier`	`2`	1–10	Motions per held-key repeat. `1` keeps terminal speed. See Held-key speed .
`editor.directory_tree_width`	`33`	12–240	Preferred directory tree width in columns.
`editor.show_hidden_files`	`false`	boolean	Show dotfiles in the explorer, finder, and workspace search. `.` toggles it in an explorer.
`editor.explorer_sort`	`name`	`name`, `modified`, `size`, each also `_descending`	Explorer order. Directories always come first.
`editor.explorer_details`	`false`	boolean	Show `ls -l` style mode, owner, size, and time columns. `?` toggles it in an explorer.
`editor.soft_wrap`	`false`	boolean	Wrap long lines visually without changing the text.
`editor.always_wrap_rendered_markdown`	`true`	boolean	Always wrap rendered Markdown pages, including rendered scratchpads. When false, follow `editor.soft_wrap`. Does not affect Markdown source.
`editor.render_whitespace`	`false`	boolean	Show `·` for spaces, `→` for tabs, and `¬` for line endings.
`editor.zen_width`	`100`	1–1000	Maximum text width while `:zen` is active.
`editor.hard_wrap_width`	`80`	1–1000	Width used by `Space p w` (hard wrap) and `Space p r` (reflow).
`editor.scratch_markdown`	`true`	boolean	Treat the pathless scratch buffer as Markdown for `Space p r` and `?`.
`editor.trim_trailing_whitespace`	`true`	boolean	Remove spaces and tabs at line ends when saving.
`editor.mouse`	`true`	boolean	Capture the mouse for selection, scrolling, and pane resizing. `false` keeps the terminal’s own text selection. Restart required.
`editor.word_completion`	`true`	boolean	Suggest words already open elsewhere in the workspace.
`editor.word_completion_minimum`	`3`	1–32	Prefix length before word suggestions appear.
`editor.fast_pane_keys`	`false`	boolean	`Ctrl-h/j/k/l` move between panes without the `Ctrl-w` prefix.
`editor.selecting_motions`	`true`	boolean	`w/b/e/W/B/E` and `f/t/F/T` select what they cross, as in Helix. `false` moves a caret instead.
`editor.auto_close_terminal`	`true`	boolean	Forget terminal sessions and their output when the program exits. `false` retains future exited sessions for review in the Finder and `Space t t`.
`editor.terminal_theme_colors`	`true`	boolean	Use the active theme for terminal ANSI colours 0–15. Applies immediately, including existing output.
`editor.command_mode_dim`	`true`	boolean	Gray out pane text while a command prompt is open.

Workspace settings

Setting	Default	Values	What it does
`mode`	`ide`	`editor`, `ide`, `mux`	The mode of a launch with no `--editor`, `--ide`, or `--mux`. `editor` needs no workspace; `mux` makes a bare `runyte` start or reuse the project’s host. The deprecated `workspace.mode` (`standalone`, `persistent`) is still read, with a notification naming its replacement. Restart required.
`workspace.session_strip`	`auto`	`auto`, `always`, `hidden`	When to show the row of running persistent sessions. `auto` shows it when more than one is running.
`workspace.idle_retirement_minutes`	`0`	0–43200	Minutes a clean, unattached host stays alive. `0` keeps hosts running. Applies without restarting the host.
`workspace.state`	`.runyte`	path	Where the workspace keeps runtime state. `workspace.root` is an accepted alias. See Where workspace state lives .
`workspace.state_anchor`	unset	`profile`, `local-app-data`	Windows only. See Windows state anchor .

:session-stop stops a host explicitly, whatever the retirement interval.

Other settings

Setting	Default	Values	What it does
`git.refresh_interval_seconds`	`60`	0–3600	Bounds automatic Git refresh. `0` turns it off. See Automatic Git refresh .
`notifications.history_limit`	`50`	1–1000	Newest notifications kept in memory for the workspace.
`lsp.enable`	`true`	boolean	Allow configured language servers to start. Restart required.
`lsp.<language>`	`rust` only	`command`, `args`, `initialization_options`	A language server definition. See Language servers .
`theme`	`ocean-dark`	theme name	The active theme. See Themes .