DOCUMENTATION / Using modisa
Settings
Everything modisa lets you change, searchable, from one page.
The settings page
Ctrl+B s, or ⚙ settings in the sidebar. The sections run down the side; type to search every one of them at once. Tab or a click switches section, ↑↓ or the pointer selects, ←→ changes a value, Enter, space or a click applies, Esc closes. The line under the list says what the selected setting does. Every change applies at once and is saved to ~/.config/modisa/config.toml, keeping your comments.
Sections
| Section | What it sets |
|---|---|
| theme | Ion, Tokyo Night, Catppuccin (Mocha and Latte), Gruvbox (dark and light), Nord, Dracula, GitHub Light, Solarized Light, the Bearded themes, and your own — previewed live. |
| general | The prefix key, select on hover, updates (and their channel), and the config file itself. |
| layout | The sidebar (shown, width, logos), what the status row shows, and pane borders. Where the sidebar and tab bar go, and formats for the status row, tabs and titles, are in config.toml: see Make it yours. |
| git | The repository name, branch, ↑↓ commit counts and ● changed files in the status row, each on or off. |
| indicators | The state glyphs (symbols ! ◆ ✓ ○, dots or letters) and where they show: tab badge, pane border, sidebar. |
| sound | What plays when an agent needs you, is done, or starts working — 17 sounds from cuelume, or off — and the volume. |
| alerts | Toast, system notification and terminal bell, per event. |
| agents | What an agent may do to panes it didn't start (allow, ask or deny), and how much agents may message each other. |
| integrations | Every agent's integration: installed, update available, available, not found. See Integrations. |
| plugins | The plugin manager, your plugins (start, stop), and each running plugin's own settings. |
| slots | Who draws each part of modisa's chrome that a plugin can replace: modisa, or a plugin that asks. See Slots. |