Configure Yazelix Nova

Inside Nova, press Alt Shift K to open Ratconfig. From another terminal, run:

yzx config

Ratconfig shows packaged defaults, saves explicit overrides, and marks Home Manager-owned files as read-only.

Main settings

The optional root config is:

~/.config/yazelix/config.toml

Nova does not create this file until you save a root setting. Missing keys inherit packaged defaults. Unsupported or misspelled paths fail validation.

Common fields include:

Field	Default	Applies to
appearance.mode	dark	Managed component appearance
appearance.straight_border_style	single	New sessions
shell.program	nu	New panes
shell.atuin	true	New managed shells
editor.command	yzx-hx	New editor opens
forest.enabled	true	New managed Helix editors
forest.side	right	New managed Helix editors
sidebar.command	radar	New sessions
sidebar.args	[]	New sessions with a custom sidebar command
welcome.enabled	true	New launches
agent.command	auto	New agent popups
keybindings.sidebar	Alt Shift H	New sessions
keybindings.sidebar_focus	Ctrl y	New managed Helix editors
bar.widgets	Nova widget list	New launches

For example:

[appearance]
mode = "light"

[shell]
program = "fish"

[editor]
command = "nvim"

Ratconfig labels each field with its apply timing. Start a new session for fields marked next launch or next session.

Straight borders may be single or double. Zellij’s native rounded corners take precedence when enabled. Set forest.enabled = false to start managed Helix without Nova configuring or opening Forest.

Radar is the default sidebar. Set sidebar.command = "yzx-yazi" to use Nova’s managed Yazi there, or select another executable and pass its arguments through sidebar.args. Custom sidebar commands do not receive Radar-specific keys, permissions, onboarding, or diagnostics.

Native files

Component-specific configuration lives beside config.toml:

Surface	Path
Nova Rio configuration	~/.config/yazelix/rio/config.toml
Guarded Zellij scalars	~/.config/yazelix/zellij/config.kdl
Extra Zellij plugins	~/.config/yazelix/zellij/plugins.kdl
Starship overrides	~/.config/yazelix/starship.toml
Nushell additions	~/.config/yazelix/nu/env.nu, nu/config.nu
Helix overrides	~/.config/yazelix/helix/
Yazi config and assets	~/.config/yazelix/yazi/

Ratconfig exposes exact file actions for these surfaces. Native owners keep their own validation and schema.

Home Manager

The Home Manager module owns one enable flag, package selection, sparse programs.yazelix.config.settings, and optional native files. It writes no runtime config unless you declare one of those options.

Store-backed files appear as read-only in yzx config. Edit the named programs.yazelix.config.* option, then run your normal Home Manager switch.

Generated state

Nova writes generated runtime state to ${XDG_DATA_HOME:-$HOME/.local/share}/yazelix unless YAZELIX_STATE_DIR overrides it. Edit the config inputs, not generated output.

See the repository configuration reference for the complete field and native-file contracts.