# Settings overview

Solo's settings give you control over app appearance, terminal behavior, sidebar behavior, workspaces, notes and todos, hotkeys, agents, tools, MCP, notifications, and your account — all in one place.

## Opening settings

You can open settings in several ways, including:

- Use the **Open settings** shortcut. It defaults to `Cmd+,` on macOS and `Ctrl+,` on Windows and Linux, and can be remapped or disabled under **Settings > Hotkeys**.
- On macOS and Linux, go to **Solo > Settings** in the [application menu](../command-palette/native-app-menus.md). The application menu is hidden on Windows.
- Open the [command palette](../command-palette/using.md) and search for “Settings.” The palette shortcut defaults to `Cmd+K` on macOS and `Ctrl+K` on Windows and Linux, and can also be remapped or disabled.
- Click **Settings** at the bottom of the sidebar when the [settings footer](./sidebar-settings.md#sidebar-footer) is visible.
- Right-click the workspace rail and choose **Manage workspaces…** to open **Settings > Workspaces**.
- In an agent terminal's MCP details, choose **Open MCP settings** to open **Settings > MCP**.

Keyboard shortcuts depend on the current UI context; see [When shortcuts are active](../keyboard-shortcuts/default-reference.md#when-shortcuts-are-active) for overlay and Hotkeys-tab restrictions.

Settings open as a panel inside Solo, not a separate window.

## Settings tabs

| Tab | What's inside |
|-----|---------------|
| **Appearance** | Theme, interface font family, and interface font scale |
| **Terminal** | Terminal behavior, font family/weight/size, line height, letter spacing, copy-on-select, focus borders, scroll wheel speed for TUI apps, macOS [Option-as-Meta](../terminal/keyboard-input.md), and [agent context pins](../terminal/context-pins.md) |
| **Notifications** | Notification permission status, test notification flow, and bell sound |
| **Sidebar** | [Filter visibility](./sidebar-settings.md), subgroup order, section header lines and counts, empty-section visibility, focus-on-open behavior, project/process stats thresholds, project header quick actions, and settings footer |
| **Workspaces** | Workspace names, icons, ordering, and deletion — see [Managing workspaces](../workspaces/managing-workspaces.md) |
| **Notes & todos** | Scratchpad and todo MCP enablement, sidebar visibility, empty-section visibility, preview counts, and exposed MCP tools |
| **Hotkeys** | Search, remap, disable, or reset [configurable shortcuts](../keyboard-shortcuts/customizing.md) |
| **Agents** | Agent naming behavior, agent tool configuration, enabled state, and [auto-summarization](../agents/auto-summarization.md) |
| **Tools** | [Default editor](./tools-editors-terminals.md), terminal, and browser for quick-open actions |
| **MCP** | MCP server enablement, stdio client setup, feature-tool toggles — including [prompt template](../prompt-templates/overview.md) MCP tools — and the local [HTTP API](../integrations/http-api.md) |
| **Account** | License status, activation/deactivation, feedback, updates, app version, and acknowledgements |

## Navigating settings

Click a tab name to switch to it.

Most settings save immediately. A few fields show an explicit **Save** button, such as model text fields or port fields. The HTTP API port can only be changed while the HTTP API is disabled, and it takes effect the next time that server starts.

When no dialog or overlay is open above Settings, press `Escape` to close Settings. If a dismissible overlay is on top, `Escape` closes that overlay first; a non-dismissible overlay leaves Settings open.

## Settings storage

Settings are saved locally on each device. They aren't shared via `solo.yml`.

## Resetting settings

If you need to reset specific settings or core app state, see [Resetting Settings](../troubleshooting/resetting-settings.md).

---

Are you a human? Read this doc on the web: https://soloterm.com/docs/settings/overview