Settings & Theming

Open with the Menu button (top right) or Ctrl+Space =. Every change applies live and persists to ~/.luvus/config.json.

Persistence runs off the UI loop. Rapid edits coalesce while an earlier write finishes, and unrelated settings saved by another named session are preserved. If storage is busy or a write fails, Luvus retains the changes for retry and reports the failure. Socket-based config reload waits for pending saves rather than replacing the live settings with an older disk copy.

Tab	What’s there
General	Open files with (read-only or an editor you have installed) and File click behavior (Preview, the default, or Open in tab), see Browsing & Opening Files, then a Notify section with Retro, Soft, and Pulse sound styles, separate done and blocked toggles, and a test row for each cue
Theme	17 bundled palettes, installed community/local themes, and the client-derived Terminal theme, previewed live as you move; installed rows include a right-aligned remove action
Layout	pane gaps, pane titles, automatic mobile width, resume-into-workspace behavior, sidebar docks, DIFF layout and limits, and [Top] [Bottom] [Off] placement for every Luvus Bar widget
Keys	every command’s binding: click one, press the new key (⌫ resets to default)
Modules	installed extensions: enable/disable, action counts, load warnings
Integrations	install/uninstall the per-agent session hook (Claude · Copilot · Codex · opencode · Kimi · Grok · OMP)
Language	the UI and human CLI information in 9 languages (en · es · pt · fr · de · id · zh · ja · ko), swapped live; command syntax, JSON, and UHP remain canonical

These docs run on the same palettes: the picker in the header (or in the menu on a phone) repaints this site with the theme you are curious about, so you can see how gruvbox or catppuccin latte reads before switching the app to it. The colours come straight from luvus’s own registry, so what you see here is what the app ships. To create your own palette, open the interactive Theme Maker: every semantic color repaints a live Luvus interface. Download the TOML, publish it for community review, or install a reviewed theme with luvus theme install community/<id>. Installed themes can be removed from the action on the right of their Settings row; removing the active one switches to the bundled default first. See Community Themes for composition, validation, installation, removal, and publishing.

Arranging the sidebars

The Layout tab, below its ── Docks ── divider, is where you move the Workspaces and Agents docks (and any a module adds) between the left sidebar, the right sidebar, or off, and toggle or size each side. The full walkthrough is in Panes, Tabs & Workspaces.

The ── DIFF ── section chooses Auto, Split, or Stack layout, line wrapping, Git context lines, source line numbers, change markers, theme or standard red/green change colors, and live refresh. See DIFF Review for the review workflow and its safety caps.

Keybinding notes: arrows and hjkl both work for focus, Tab/Shift+Tab cycle tabs, and every prefix command is remappable, including the vim aliases. The Prefix row captures a safe function key or Ctrl/Alt chord and asks you to press it again before saving. The Preset row provides luvus (default), no-Ctrl (F12), and tmux bundles. Press the configured prefix and then ? to show the current map. See Keybindings for the full list.