Configuration
⌘, — or the address savoia://configuration, typed into the field.
The ? in a section’s top right corner opens this guide’s page about it, in a new tab. Help ▸ Savoia Guide does the same for whatever is in front: the start page, a section of the configuration, the chats.
Every section has an address of its own: savoia://configuration/assistant,
/privacy, /windows, /extensions, /develop. Privacy and Assistant hold
tabs inside them, and those are anchors on that page, after a #:
/privacy#blocking, /privacy#sites, /privacy#certificates,
/assistant#responses, /assistant#agents, /assistant#mcp — so Site
Permissions… in a window’s permission menu arrives at the permissions rather
than at the filter lists. Buttons like Set Up… in the
⌘E line open the section they mean rather than the top of the page, and the
address follows you as you move between sections.
Configuration here is a page, not a window of its own. It opens as a tab, it has an address, it keeps its place across a relaunch, and it can stand beside a site and close like any other tab.
Where this came from
Savoia used to have thirteen menus, five of them one feature each with a switch inside — the kind you set once and forget. A switch is not a command: it has no key, it does not answer “what can I do here”, and there is no guessing which of five menus it filed itself under. All of that moved here, and what stayed in the menus is what a menu is for: things you do, with a key beside them.
General
Updates — Automatically Check for Updates checks when Savoia starts and then daily. It is on by default. Savoia ▸ Check for Updates… checks at any time, even when automatic checks are off. When a new version is available, the update window offers to download and install it; Savoia relaunches with the open tabs and groups restored. Updates are available in the installed Release app, not Savoia dev.
Search engine — DuckDuckGo, Google, Bing or Yandex. The same choice is the chip on the left of the field on the start page.
Translation — the language pages are translated into (⌘⇧L). The list is
whichever languages macOS has a model for.
Bookmarks — what the assistant searches (this profile or all of them) and how often a saved page is re-read from its site. Also how many are saved in this profile, and a button to re-read them all now.
Default browser — hand Savoia the links from other applications. A development build never offers: it is a second application wearing the same face, and links from the whole machine would go into a browser that is about to be killed and built again.
Appearance
Appearance — Automatic (as macOS is), Light or Dark: windows,
menus and pages that honour prefers-color-scheme turn light or dark whatever
the system is set to. An Automatic app icon follows this choice.
App icon — which icon Savoia shows in the Dock. Wings (the default) is the red wings on a sky-coloured ground; Dawn & Dusk is the larger picture with the same wings. Each comes Automatic (light by day, dark under macOS’s dark appearance), Light or Dark; Sky is the previous icon with clouds. The choice shows while Savoia is running. A quit app is drawn by macOS from its bundle, which carries the Wings pair, so it follows the appearance there but does not keep another choice.
Start page — what stands above the field: the Name (which can be changed), the Icon (the wings on a transparent ground, light or dark with the appearance), or None. The Background is picked from tiles: Plain (the profile’s tint), Glass (translucent panes washed with the icon’s colours), Wings (the icon’s wings in a corner) and Glow (blurred blue and orange).
Tabs
Group Tabs by Meaning — a new tab goes into the group it is about by itself, and three alike tabs with no group become a group. Off until you switch it on. Sort By, Local Model, Regrouping Threshold and Ask Before Regrouping — the same switch as the question’s “Don’t ask again” — are there too. More in Groups by meaning.
Old Tabs ▸ Offer to Close — how often to offer closing tabs not opened for a long time whose topic you no longer come across, and Look Now. More in Old tabs.
Loaded Tabs — how many tabs are holding a live page right now, and Free Memory. The number cannot be changed: how many separate processes a particular Mac will carry is not a thing a person can know, so Savoia works it out from the machine’s memory and adjusts as the pressure moves. A tab used in the last ten minutes is not unloaded, so switching between two tabs reloads neither of them. Free Memory unloads those too.
Privacy
Three tabs, and each of them used to be a window of its own.
Blocking — the switch, the filter lists (how many rules in each, when it last updated) and the sites you asked it to leave alone. The shield in the address field opens the same screen. More in Ads and trackers.
Site permissions — every site you have answered about the camera or the microphone, with a switch for each. More in Site permissions.
Certificates — the certificate authorities Savoia trusts on top of the system’s. Everything starts off. More in Certificates.
Assistant
Three tabs:
- Responses — who answers
⌘E, the model and API credentials. Agent model lists come from the agent itself. Access to Page Console and Network also lives here. - Agents — install or update Claude Code and Codex, add or edit other ACP agents using their launch command. Once a tool call has been answered “always”, Ask Again lives here too.
- MCP — connected servers with addresses, status and Agent Access switches. Each server’s “…” menu contains editing, connection checks, sign-in, opening apps and removal. Adding a server and browsing the MCP catalogue open separately.
Deep research settings have been removed from this page. More in The assistant, Agents and MCP apps.
The keys are stored locally
This is a development shape: the keys sit in UserDefaults, not the Keychain.
Extensions
What is installed, what each one can do here, and installing from a folder, a
.zip, a .crx or an .xpi. More in Extensions.
Develop
Remote automation, WebMCP and the browser log. More in Developer tools.
Where it all lives
Every setting is a row in the settings table of Savoia’s database, beside the
history and the bookmarks, rather than in UserDefaults, except the automatic update switch, which Sparkle
stores for this app. The database settings travel with the rest of the profile’s data and can later sync.