Add right panel close controls

[caezium]

What Changed

• Add a far-right close button that hides the inline right panel without destroying its tabs.
• Add a configurable rightPanel.closeActiveSurface command, defaulting to Mod+W while the right panel owns focus.
• Route macOS native close input and embedded Browser shortcuts through the same focus-aware path, while keeping bottom-drawer terminal closing pane-scoped.

Why

The right panel had no explicit hide control, and Cmd+W could close the desktop window instead of the focused panel surface.

Closes #4146.
Closes #4147.

UI Changes

Before

After

Interaction

Watch the real-app interaction demo

The clip starts with Files and Diff open. Cmd+W closes only Diff, the far-right X hides the panel, and the existing toggle restores Files to show that panel state is preserved.

Validation

• 16 focused test files, 200 tests passed
• Affected-package typechecks, targeted lint and formatting, and git diff --check passed
• Real Electron QA covered tab close, final-tab close, panel hide/reopen, embedded Browser routing, custom remaps, terminal scope, and app-window preservation

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

---

Note

Medium Risk
Touches global shortcuts, macOS window-close interception, and persisted keybinding migration; behavior changes when the right panel is open versus legacy terminal-only Mod+W.

Overview
Adds a far-right close control on the inline right panel and wires focus-aware close so Mod+W closes the active right-panel surface (or its terminal) instead of quitting the app when the panel has focus.

Keybindings & migration: New rightPanel.closeActiveSurface (default mod+w when rightPanelFocus); terminal.close is limited to terminalFocus && !rightPanelFocus. Server startup migrates legacy mod+w terminal-close configs and documents the new when context.

Desktop: On macOS, main-window Cmd+W is intercepted and sent to the renderer as close-window-or-focused-region (still closes the window while the main frame is loading). Preview webviews receive configured close shortcuts over IPC so embedded browser input forwards remapped bindings, not a hardcoded Mod+W.

Web: closeFocus tracking, rightPanelFocus scope (including portaled controls), and a shared close-request path in ChatView / sidebar menu handling unify keyboard, menu, and preview forwarding.

^{Reviewed by Cursor Bugbot for commit 02b9f3f. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add right panel close controls with focus-aware Cmd+W routing

• Adds a close button (X) to PanelLayoutControls and routes Cmd+W to close the focused right panel surface, right panel terminal, or drawer terminal based on where focus is tracked.
• Introduces createCloseFocusTracker in closeFocus.ts to maintain stable focus ownership across native blur events, portals, drag regions, and preview tab switches.
• Splits the default mod+w keybinding into two: rightPanel.closeActiveSurface when rightPanelFocus is active, and terminal.close only when terminalFocus && !rightPanelFocus; includes a startup migration for existing persisted configs.
• On macOS, Cmd+W in the desktop app is intercepted via before-input-event and routed to the renderer as CLOSE_WINDOW_OR_FOCUSED_REGION_MENU_ACTION instead of immediately closing the window (unless the main frame is still loading).
• Preview windows receive configured rightPanelCloseShortcuts via a new IPC channel so the preview manager can forward the correct shortcut instead of always assuming Mod+W.
• Risk: The terminal.close default keybinding now requires !rightPanelFocus, which is a behavioral change for users whose right panel is open when they press Cmd+W.

^{Macroscope summarized 02b9f3f.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 6d66ce6a-fe4b-498d-9a58-a70b5be0241c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new feature (right panel close controls) with significant new logic including focus tracking, shortcut routing, and behavioral changes to how Cmd+W works. Combined with an unresolved review comment about a potential race condition, this warrants human review.

^{You can customize Macroscope's approvability policy. Learn more.}

[juliusmarminge]

what is the interaction demo doing? looks like you're just toggling visibility which you can already do with Mod+Shift+B ?

[caezium]

pressing cmd+w to close a single panel, since in the vid there was only one, the whole panel closed, sorry for the bad video, ill record another one

[caezium]

Updated the PR description with a separate real-app middle-click demo. It starts with Files and Terminal open, then middle-click closes only Files while Terminal, the right panel, and the app window stay open. I also added focused regression coverage for button 1 and clarified what the existing Cmd+W clip is showing.

[caezium]

Follow-up review fix in 85e780f: hosted preview focus is now matched by tab ID against the active right-panel preview, so a standalone preview cannot trigger the right-panel close shortcut. The focused tests cover matching and mismatched preview IDs.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 117cbae. Configure here.}