Right-Click Setting Affordances

What it is

Right-click certain live UI elements to Hide them or jump to their setting. Covers the subagent activity card, Auto-Waited tag, voice button, close (✕) button, context-% ring, alternate-providers chip, and the current-branch badge — plus the auto-waiting surfaces (the Keep waiting / Check in composer buttons, the collapsed Auto-waited + Background check-in markers, and the scheduled-wake countdown banner), which offer an open-setting-only menu (just Open setting…, no Hide — an action button / collapsed marker has no boolean to hide).

Where to find it

There is no screen to open for this — it is a right-click gesture on live parts of the app. Right-click (or long-press for about half a second on a touch screen) one of these elements and a small menu appears at the pointer: the subagent activity card, the Auto-Waited tag, the voice button, the close button on a session, the context-% ring, the alternate-providers chip, or the current-branch badge.

That menu offers Hide, which turns that element's setting off so it disappears at once, and Open setting…, which opens Settings, scrolls to the matching control and highlights it.

The waiting surfaces — the Keep waiting and Check in buttons in the composer, the collapsed Auto-waited and Background check-in markers, and the scheduled-wake countdown banner — are right-clickable too, but their menu only offers Open setting…, since an action button or a marker has no on/off state to hide.

How it behaves

How it works

• Hide [element] — turns that element's setting off, so it disappears immediately. A toast confirms with Undo (and an Open settings shortcut). Because a hidden element can no longer be right-clicked, Undo and Settings are the re-enable paths.
• Open setting… — opens Settings, scrolls to the element's toggle, and pulses it. Also how you turn it back on. (For most elements this lands in the Sessions section; the alternate-providers chip lands in Accounts and the branch badge in Appearance — the section is looked up automatically from the settings search index.) If the target toggle sits inside a collapsed Advanced fold, the fold opens automatically so the pulsed row is visible — the same auto-expand that lets Settings search reach a folded control (see .claude/memory/contracts/settings-disclosure-contract.md).

Right-click on desktop, or long-press (500 ms) on touch — the same menu opens at the pointer/finger. (Some elements are desktop-only anyway, but the Auto-waited tag/markers and the waiting buttons appear on mobile too, where long-press reaches them.)

For agents

Internals

• Registry: src/renderer/src/features/setting-affordances/setting-affordance-registry.ts maps element → { label, settingsKey?, settingId } (settingsKey optional — omitted = open-setting-only, no Hide row). Single source of truth.
• Menu: SettingAffordanceMenu.tsx (presentational, reuses the shared useMenuKeyboard + clampToViewport + CONTEXT_MENU_BUTTON pattern). Hook: useSettingAffordanceMenu.tsx returns { triggerProps, menu }.
• Hide writes through settingsStore.updateSetting; Open-setting routes via wizardStore.setPendingSettingId + navigateToSettingsProject. The section is resolved from SETTINGS_SEARCH_INDEX by settingId at click time.
• Contract + invariants: .claude/memory/contracts/setting-affordance-contract.md.

Related

• settings-reference.md — the catalogue of Settings controls these right-click menus expose.
• settings/sessions-and-agents.md — the session settings the affordances act on.
• settings/appearance.md — the appearance settings the same affordances reach.