GUI

The Mac GUI

A native SwiftUI menu-bar agent (look for ✦ in the menu bar). It's a thin view over the same agent-cli-menu back-end — it never parses your config or reads ~/.claude/ itself, so the GUI and terminal always agree.

Opening it

• Left-click ✦ → popover.
• Right-click ✦ → Open / Open in window / Quit.
• Global hotkey (if set) → opens the resizable window from anywhere.
• The window is resizable and remembers its size/position.

New / Resume

A segmented control switches tabs; ⇥ does the same from the keyboard. The search field keeps focus the whole time — type to filter, ↑/↓ to select, ↵ to launch/resume, esc to clear or close. Selection is a full-row highlight and auto-scrolls into view.

• New — project dirs grouped by section (colored headers), frecency-sorted, with the git branch per row. ＋ New dir creates a directory under any group. The tool to launch is picked bottom-right.
• Resume — sessions with a status dot (busy / idle / inactive), name, path, and branch. A ⚠ marks an uncertain working directory (you'll be asked to confirm before resuming).

Transcript preview

In Resume, toggle the preview pane (eye icon, or ⌘P) to read a session's recent transcript on the right before resuming. It's fetched lazily (debounced) and cached per session.

Settings

The gear opens a full editor that writes the same config as the terminal:

• Open sessions in — the terminal to launch into: system default, Terminal, iTerm, Ghostty, Warp, kitty, WezTerm, cmux, or a custom command.
• Groups — name, folder (with a … picker), and a color (native ColorPicker + hex field).
• Tools — name + runs command; pick the default.
• IDEs — ctrl-key → label → command.

Launch shortcut

Click the recorder field and press the combo (e.g. ⌘⇧M). It only accepts shortcuts it can actually register, and esc clears it. Stored as [gui].hotkey in the config.

First launch

The app is ad-hoc signed (not notarized) — see Installation → Gatekeeper. If a launch/resume fails (e.g. agent-cli-menu isn't on PATH), the GUI shows an alert rather than failing silently.