Bob Mac Capture is the optional native menu-bar panel for capture. It is a thin client of the CLI: it never parses capture grammar or writes the vault itself. It runs `bob`, renders the preview, and submits one `bob capture` call per draft that only hides once `bob` reports success. The reasoning is recorded under [Bob Mac Capture Is A Thin Client Of bob](<https://bobs-org.github.io/develop/decisions/#mac-capture-is-a-thin-client>).

Build it from source with [Continue with Mac Capture](<https://bobs-org.github.io/start/mac-capture/index.md>). Platform install and signing are in [Install](<https://bobs-org.github.io/reference/mac-capture/install/index.md>). The canonical token contract is [Capture syntax](<https://bobs-org.github.io/reference/capture-syntax/index.md>); install and platform requirements are also in [Requirements and compatibility](<https://bobs-org.github.io/reference/compatibility/index.md>).

## Install and settings

- [Install](<https://bobs-org.github.io/reference/mac-capture/install/index.md>) for platform requirements, signed install, updates, rollback, and uninstall.
- [Settings](<https://bobs-org.github.io/reference/mac-capture/settings/index.md>) for the Settings window in `SettingsView` order.
- [Permissions](<https://bobs-org.github.io/reference/mac-capture/permissions/index.md>) for Accessibility, notifications, launch at login, and what is stored.

## Capture

- [Capture panel](<https://bobs-org.github.io/reference/mac-capture/capture-panel/index.md>) for the panel, editor, completion, drafts, live preview, submit, and stash.
- [Pickers](<https://bobs-org.github.io/reference/mac-capture/pickers/index.md>) for the shared picker lifecycle, with [task pickers](<https://bobs-org.github.io/reference/mac-capture/task-pickers/index.md>) and [relationship pickers](<https://bobs-org.github.io/reference/mac-capture/relationship-pickers/index.md>).
- [Capture previews](<https://bobs-org.github.io/reference/mac-capture/capture-previews/index.md>) for preview cards, session controls, completions, and successor offers.

## Keyboard and agenda

- [Keyboard](<https://bobs-org.github.io/reference/mac-capture/keyboard/index.md>) for every binding: editor, completion, prompts, stash, shelf, and today's Pomodoro.
- [Idle agenda](<https://bobs-org.github.io/reference/mac-capture/idle-agenda/index.md>) for today's Pomodoro agenda in an empty draft.

## Draft aids

- [Saved templates](<https://bobs-org.github.io/reference/mac-capture/saved-templates/index.md>) for the Control-T template shelf.
- [Wikilink completion](<https://bobs-org.github.io/reference/mac-capture/wikilink-completion/index.md>) for Obsidian note, heading, block, and alias rows.

## Bob Refs

- [Bob Refs](<https://bobs-org.github.io/reference/mac-capture/refs/index.md>) for the library panel, ranking, cards, opening, and Tabs.
- [Bob Refs inspector](<https://bobs-org.github.io/reference/mac-capture/refs-inspector/index.md>) for the hydrated inspector column.

## Protocol and diagnostics

- [Diagnostics](<https://bobs-org.github.io/reference/mac-capture/diagnostics/index.md>) for the menu-bar icon, signposts, timeouts, Copy Diagnostic, and `refs-rank`.
- [Protocol](<https://bobs-org.github.io/reference/mac-capture/protocol/index.md>) for subprocess commands, JSON boundaries, capability requirements, and older-Bob compatibility.
- [Development](<https://bobs-org.github.io/develop/mac-capture/index.md>) for architecture, build, and CI.

## Fix problems

- [Fix Mac Capture when bob is not resolved](<https://bobs-org.github.io/guides/fix-mac-capture-bob-resolution/index.md>)
- [Resolve a Mac Capture hotkey conflict](<https://bobs-org.github.io/guides/resolve-mac-capture-hotkey-conflict/index.md>)
- [Restore Mac Capture permissions](<https://bobs-org.github.io/guides/restore-mac-capture-permissions/index.md>)
- [Recover Bob Refs](<https://bobs-org.github.io/guides/recover-bob-refs/index.md>)
- [Recover a stuck Mac Capture panel](<https://bobs-org.github.io/guides/recover-mac-capture/index.md>)
- [Build](<https://bobs-org.github.io/develop/mac-capture/build/index.md>) for XCTest and toolchain diagnosis.