Settings
All 16 settings tabs explained — profiles, shortcuts, behavior, and more.
Settings
Mosaic's settings are organized into 16 tabs plus a raw JSONC view. Open settings from the command palette (Ctrl+Shift+P, then type "settings") or from the application menu.
Fuzzy Search
A search bar at the top of the settings panel lets you type to filter across all tabs. Matching settings are highlighted and non-matching tabs are dimmed, so you can find any setting without knowing which tab it lives in.
Settings Tabs
Profiles
Create, edit, and delete shell profiles. Each profile specifies:
| Property | Description |
|---|---|
| Shell | Path to the shell executable (e.g., cmd.exe, pwsh.exe, /bin/zsh) |
| Arguments | Command-line arguments passed to the shell |
| CWD | Default working directory for new terminals using this profile |
Set any profile as the default. When you open a new terminal, it uses the default profile unless you choose another from the new-terminal menu.
Tip: Create separate profiles for different environments -- one for PowerShell, one for Git Bash, one for WSL -- and switch between them when creating new terminals.
Appearance
Visual customization of the entire application. See Appearance & Theming for full details.
| Setting | What it controls |
|---|---|
| Theme | Choose from 9 built-in dark themes |
| Font family | System font picker or load from file |
| Font size | Base terminal font size |
| Font ligatures | Enable/disable ligature rendering |
| Background image | Per-workspace wallpaper |
| Window opacity | 20-100% with frosted-glass effect |
| Wallpaper opacity | 10-100%, independent of window opacity |
| Tab style | Cards, Minimal, Pills, Underline, or Glass |
| Status bar height | 16-40px with auto font scaling |
Shortcuts
All 41 rebindable keyboard shortcuts in one place. See Keyboard Shortcuts for the full list.
- Click any shortcut to rebind it
- Conflict detection: if your new binding clashes with an existing shortcut, Mosaic warns you before saving
- Reset individual shortcuts or all shortcuts to defaults
Behavior & Confirmations
Fine-grained control over terminal behavior and confirmation dialogs:
| Setting | Description |
|---|---|
| Close confirmations | Show/hide confirmation dialogs when closing panes, tabs, or the window |
| Terminal cursor | Style (block/underline/bar) and blink on/off |
| Scrollback size | Lines of history to keep per terminal |
| File editor | Default settings for the built-in editor |
| Git status | Toggle git status badges in the file explorer |
| Agent auto-revive | Automatically restart crashed coding agents |
| Quick-start agents | Show one-click agent launch buttons in terminal headers |
| Issue-drop agent | Configure which agent launches when dragging issues to a terminal |
| Claude prompt viewer | Toggle the prompt bar above Claude Code terminals |
Quake Terminal
A drop-down terminal that slides in from the top of the screen, toggled by a global hotkey.
| Setting | Description |
|---|---|
| Global hotkey | The system-wide key combo to toggle the quake terminal |
| Window height | Percentage of screen height (10-100%) |
| Window width | Percentage of screen width (10-100%) |
| Animation | Slide or fade transition |
| Always-on-top | Keep the quake terminal above other windows |
| Hide-on-blur | Automatically hide when the quake terminal loses focus |
Tip: The quake terminal is ideal for quick commands -- bind it to a key you can reach without looking (like the backtick key) and it becomes muscle memory.
Layouts
Save and restore pane arrangements as named presets.
| Action | Description |
|---|---|
| Save | Capture the current layout as a named preset |
| Load | Restore a saved layout, replacing the current arrangement |
| Rename | Change a preset's name |
| Delete | Remove a saved preset |
| Export | Save a preset to a JSON file for sharing |
| Import | Load a preset from a JSON file |
Snippets
Full snippet management with create, edit, and delete. Each snippet has a name, command, optional alias, optional category, and scope (global or workspace).
See Snippets for usage details including alias expansion and the snippet palette.
CI Status
GitHub Actions monitoring configuration:
| Setting | Description |
|---|---|
| Enable/disable | Turn CI status monitoring on or off |
| Repository | Owner and name of the GitHub repository to monitor |
| Branch | Which branch to track (e.g., main, master) |
When enabled, Mosaic shows a status badge in the status bar with recent workflow run results. Clicking it opens a dropdown with run details and a "Fix It" button that spawns an agent to investigate failures.
Language Servers
Manage language servers for code intelligence features:
- View available language servers and their status
- Install servers with one click
- Check connection status and restart servers
- Servers auto-detect by file type when you open files
See the File Viewer docs for how language servers power IntelliSense in the editor.
Shell Integration
Configure shell-specific integrations:
| Setting | Description |
|---|---|
| Clink aliases | Custom aliases for cmd.exe sessions |
| Prompt settings | Customize the cmd.exe prompt format |
Remote
Remote access for LAN connections:
| Setting | Description |
|---|---|
| Port | Server port for remote connections |
| Auth token | Authentication token for remote connections |
When enabled, Mosaic serves a web interface that other devices on your network can access through a browser.
Notifications & Alerts
Control how Mosaic notifies you about terminal activity:
| Setting | Description |
|---|---|
| Completion sounds | Choose from 6 built-in presets (chime, ding, soft, complete, alert, success) or a custom audio file |
| Volume | Sound volume level |
| Per-workspace overrides | Different sound settings per workspace |
| Live minimap | Show a minimap preview of terminal output in notification toasts |
| Webhook providers | External notifications via ntfy, Discord, or Telegram |
Tip: Set up webhook notifications to ntfy or Discord so you get pinged on your phone when a long build finishes and you have stepped away from your desk.
Usage Monitor
Claude Code token tracking with visual quota bars. Shows usage per quota period so you can see how much of your allocation you have consumed.
LLM Settings
Configure smart tab naming powered by a local LLM:
| Setting | Description |
|---|---|
| Mode | Embedded (bundled model) or external endpoint |
| Model selection | Choose which model to use |
| Model download | Download models for embedded mode |
When enabled, Mosaic uses a lightweight LLM to generate descriptive tab names based on terminal content, replacing generic "Terminal 1, Terminal 2" labels.
Backup & Restore
Full settings export and import with selective category control:
| Action | Description |
|---|---|
| Export | Save all settings to a JSON file |
| Import | Restore settings from a JSON file |
| Category selection | Choose which setting categories to include in export/import |
Categories include: workspaces, profiles, snippets, shortcuts, appearance, behavior, and more. This lets you share your theme and font settings with a colleague without overwriting their workspace layouts.
About
Application version and update management:
- Current version number
- Check for updates with download progress
JSONC View
A raw settings viewer that shows the complete configuration in JSONC (JSON with Comments) format:
- Read-only by default to prevent accidental edits
- Copy settings to clipboard
- Save to export a snapshot
This view is useful for auditing your full configuration or copying specific values to share.
Persistence
All settings are automatically saved and persist across restarts. Settings are stored in your OS user data directory, so they survive application updates. Use the Backup & Restore tab to export your configuration if you want to transfer settings to another machine or keep a backup.
Related
- Appearance & Theming -- deep dive into themes, fonts, and visual customization
- Snippets -- alias expansion and the snippet palette
- Terminal -- cursor, scrollback, and rendering settings in action
- Getting Started -- initial setup and configuration