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.
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 → |