Skip to content

macOS settings

Rui edited this page Nov 3, 2026 · 1 revision

macOS settings

The macos role (tags macos, dock, menubar, finder, keyboard, appearance, screenshots, touchid):

  • Dock: size, on the right, magnification, animation, indicators; the bottom-right hot corner (Quick Note) off
  • Finder: extensions, hidden files, path bar, status bar, column view; no .DS_Store on network shares or USB drives
  • Appearance: dark mode
  • Menu bar: Sound always shown
  • Spaces: no automatic rearranging; "Displays have separate Spaces" off (AeroSpace recommends it; needs a logout); clicking the wallpaper only reveals the desktop in Stage Manager
  • Screenshots: saved to ~/Pictures/Screenshots, without the window shadow
  • Keyboard: full keyboard access, no smart quotes or dashes, the Spotlight shortcuts off, Siri off; with AeroSpace, Mission Control's ctrl ←/→ off
  • Touch ID for sudo: pam_tid.so in /etc/pam.d/sudo_local (it survives macOS updates), after pam_reattach (Homebrew pam-reattach) so it works inside tmux too. Needs the sudo password asked at the start; skipped when left empty. Alone: --tags touchid.

⌘Space

Spotlight and Siri both bind ⌘Space; Siri's default is hold ⌘Space, which swallows the keystroke before any app sees it. The playbook frees the shortcut, but cannot set Raycast's hotkey: Raycast keeps it in an encrypted database with no defaults key. Set it by hand (Manual steps).

Reference: roles/macos/README.md.

Clone this wiki locally