Settings

The Settings window is a 560 pt form. Section order matches SettingsView: Bob, Hotkey, References, Agenda, Similar Tasks, Canceled Draft Stash, Saved Templates, Launch, Notifications, Diagnostics. The app owns these controls. Capture grammar, template capacity, and vault mutation stay in bob (thin client decision). Values persist in UserDefaults under org.bobs.bob-mac-capture unless noted as transient.

Install identity and executable search are in Install. Permission grants are in Permissions. Panel keys are in Keyboard. Refs behavior is in Bob Refs.

Bob¶

Candidate locations when the override is empty are in Install.

Hotkey¶

One Carbon handler (HotKeyRegistry, signature 'BOBC') owns capture (id 1), Refs (id 2), the Highlights-frontmost open key (id 3), and the Highlights Tabs key (id 4). Each registration is independent: a failed one leaves the others intact. A conflict reports Hotkey conflict (or Refs hotkey conflict: …) in Diagnostics and Recent Activity. Recovery is in Resolve a Mac Capture hotkey conflict.

References¶

Toggling these controls re-registers the Refs bindings immediately. Opening, Tabs, inspector paging, and open-PDF update notices are in Bob Refs and Bob Refs inspector.

Agenda¶

Agenda facts come from bob capture-pomodoros --tasks. Layout and folding are in Idle agenda.

Similar Tasks¶

Matching and the JSON contract belong to bob capture-related; the Mac app owns the settle delay and row presentation. See Protocol and Capture previews.

Canceled Draft Stash¶

Canceled drafts live on disk and survive quit and restart. Capacity 0 or Clear Stash... deletes the file. Storage rules are in Permissions. Stash keys are in Keyboard and Capture panel.

Saved Templates¶

This section reports bob capture-templates state. It does not expose capture.max_saved_templates as an in-app control; that key stays in CLI configuration. While the shelf is available it shows the saved count, the capacity, a "Saving is off" caption when capture.max_saved_templates is 0, the file path, Reveal in Finder, and confirmed Clear Templates… (also removes the quarantine copy). Loading, a list failure, or an older bob that lacks capture-templates show a caption instead of the count. Clear is disabled when the shelf is empty, unsupported, or a clear is already in flight.

Shelf behavior is in Saved templates.

Launch¶

The app cannot grant Login Items approval for itself. Recovery is in Permissions.

Notifications¶

Capture correctness never depends on notifications. Delivery and authorization persistence require the installed signed bundle; Settings › Diagnostics shows the signing state. Notification copy, the install-complete banner, and the open action are in Notifications. Open-PDF update notices are in Bob Refs. Authorization storage is in Permissions.

Notification copy¶

The app posts success and failure UNUserNotificationCenter notifications. Success notifications use Bob's semantic capture text rather than raw draft syntax: a single capture is titled Task captured or Note captured, names the destination, and includes scheduled-date metadata when Bob returns it. A close is titled Closed NAME and its body carries the session and timing line, the tasks and Work Log line, and the next-session line. A start is titled Started NAME with the session and queued-task count; a restart is titled Restarted NAME with the en-dash session, queued count, and · was 0920–0945, and a swap is titled Swapped in NAME with the taken range and the demoted session back to first future. A batch is titled with the item count, summarizes task/note and destination counts, and emits one ordered body line per captured item without substituting an ellipsis for later entries. Close batch lines append (closed NAME) and count under a Close kind; start batch lines append (started NAME …), (restarted NAME …), or (swapped in NAME …) under a Start kind. When Bob reports a global destination, a same-scope batch uses compact wording such as 2 tasks · foo.md or 2 notes · file.md · under ^a-id; only items that locally override the global declaration repeat their actual destination. The raw @@... declaration is never included in notification text. The only newly authorized notification body content is the captured semantic text; failure notifications still carry only the bounded error message. The install-complete banner uses fixed copy with no path, identity, version, or capture text.

Capture notifications register a foreground action named for the note count and store Bob's open-plan payload. Clicking the notification or pressing its open action sends one bob-open-notes URL. Older delivered notifications still route from their targetPath or targetPaths values. If Bob reports no usable destination, the notification remains informative and omits the open action. Control-Return posts the same capture-success notification as Return, then opens the notes in Obsidian. If the open fails, a second notification, "Captured, but Obsidian didn't open", carries the error.

When just install restarts a copy that was already running, the replacement process posts one native completion notification after it finishes launching:

• title: Install complete
• body: Bob Mac Capture restarted successfully.
• sound: the default notification sound
• action: Capture

Clicking the banner or choosing Capture opens the capture panel; dismissing it does nothing. The banner is confirmation that the replacement process itself reached a usable launch point, not that the install helper merely asked LaunchServices to open the bundle. It is requested only for that one-shot install-triggered restart, and only when macOS already allows notifications for the signed bundle. An install never prompts for notification permission. Denied or not-yet-requested authorization is silent and non-fatal: the replacement still launches. A stopped install does not launch the app and does not notify. menu-bar icon → Restart Bob Mac Capture is a manual relaunch, not an install completion, and does not show this banner.

Diagnostics¶

Signposts, timeouts, Copy Diagnostic, menu-bar icon states, and refs-rank are in Diagnostics.