Settings & Theming
Open with the Menu button (top right) or Ctrl+Space =. Every change
applies live and persists to ~/.luvus/config.json.
| Tab | What’s there |
|---|---|
| General | Open files with (read-only or an editor you have installed, see Browsing & Opening Files), then a Notify section: sound on done and sound on blocked, both off by default, plus a Test sound row to hear it first |
| 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, 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) |
| Language | the UI in 8 languages (en · es · pt · fr · de · id · zh · ja), swapped live |
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
Section titled “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 changes the prefix chord (e.g. to Ctrl+b), and the
Preset row applies a bundle such as tmux in one click. Ctrl+Space ?
always shows the current map. See
Keybindings for the full list.