# Settings

Five tabs, one row each for a label, a one-line outcome, and a single control — what every one of them does.

`⌘,` or the titlebar gear opens Settings; Esc, a click outside, or `⌘,` again
dismisses it. The shape is deliberate: one row is a label, a one-line
plain-English outcome, and one control on the right.

The two update lifecycles are kept apart. Mandeck the app updates through
Sparkle and lives in **Updates**; the agent CLIs update themselves and live in
**Agents**, so an app update never gets confused for a Claude Code update.

## General

*Permissions* — agents run inside Mandeck, so they get Mandeck's permissions,
not the terminal's. Nothing asks at launch and nothing nags; the rows sit here
and tell the truth until someone presses Grant.

| Row | Outcome | Control |
|---|---|---|
| Screen Recording | so agents can see the app you asked them to work on | Grant |
| Accessibility | so agents can drive a UI to test it | Grant |
| Full Disk Access | so agents can read app data and logs | Grant |
| Resume agents on launch | Reopen each pane back into its conversation, not just its dead history. | switch, on |
| Mandeck | Native build, its version and build number, and the active theme | — |

## Appearance

| Section | Outcome | Control |
|---|---|---|
| Appearance | Applies to every workspace | Wavedeck Soft · Soft Dark · Obsidian Glass · Tokyo Rain · Daybreak · Nord · Gruvbox |
| Font | Terminal typeface | Hack Nerd Font Mono · JetBrains Mono · SF Mono · Menlo · Monaco · Courier New · Andale Mono |
| Terminal font size | Applies to every pane live (`⌘+` / `⌘-` / `⌘0`) | − / pt / + / Reset |
| Scroll speed | 1.0× is your Mac's own rate — below is slower, above is faster. A mouse wheel is amplified less than a trackpad. Hold `⌥` to scroll a page-ish at a time. | slider, 0.5×–6.0× |
| Open agent links in Mandeck | Off: they open in your default browser, with your logins. Right-click a link for both, either way. | switch |
| Keyboard shortcuts | The native keymap is fixed and discoverable. | View all |

## Agents

*Your agents* — read straight from each CLI's own login. There is no separate
Mandeck sign-in: whoever you logged that tool into shows here, with its version.
Only the CLIs actually installed on this Mac appear; when none are, the card
says so and names three to try.

| Row | Outcome | Control |
|---|---|---|
| one row per installed CLI | its account and plan, or *Signed in* / *Not signed in* / *Installed* | version, and **Sign in** when it is signed out |
| Extra subscriptions | Manual, and only if you hold more than one plan: name a second account and paste a `claude setup-token`. | Get token · Paste token · Sign in · Forget |

Mandeck records only that a token is connected, never an email — the identity
above already comes from the CLI. *Default* is just the `~/.claude` every CLI
already uses. More on [Agents & subscriptions](/docs/agents-and-subscriptions).

## Away

Pairing a phone, and the two things that have to be true for it to keep
working.

| Row | Outcome |
|---|---|
| This Mac won't fall asleep on its own | while a phone is paired. A sleeping Mac looks exactly like a broken one from your phone — the list just stops moving. The display can still sleep, and closing the lid still sleeps the machine. |
| Open Mandeck when I log in | macOS holds this until you allow it in System Settings → General → Login Items. |
| Show pairing code | a code to confirm on both sides. Nothing in it reaches our servers — the secret travels in the URL fragment, which browsers never send. |
| Paired devices | when each was paired, and **Revoke** |

## Updates

*Mandeck — the app.* This tab updates Mandeck itself, through Sparkle.

| Row | Outcome | Control |
|---|---|---|
| Version | You're on the latest build Mandeck knows about — or a new one is ready, and the Update pill in the titlebar installs it. | version, **Check now** |
| Install automatically | Clicking Update always fetches the newest. This installs a downloaded build silently on quit — off means updates only when you ask. | switch, on |
| Claude Code, Codex, Gemini… | Each CLI updates itself, on its own version. Manage them where they live. | Open Agents → |