claude-code - 💡(How to fix) Fix Claude Desktop 1.11187.1 (macOS): claude:// deep link navigates in the background without foregrounding the window

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

When a claude:// deep link is delivered while Claude Desktop is already running and not frontmost, the handler navigates to the target internally but does not raise or focus the window. The navigation only becomes visible if the app is already the frontmost application. Earlier builds brought the window to the foreground in this case.

Root Cause

When a claude:// deep link is delivered while Claude Desktop is already running and not frontmost, the handler navigates to the target internally but does not raise or focus the window. The navigation only becomes visible if the app is already the frontmost application. Earlier builds brought the window to the foreground in this case.

Fix Action

Fix / Workaround

Likely cause

The app.on("open-url", …) handler calls event.preventDefault() and dispatches navigation to the webContents without a corresponding window.show() / BrowserWindow.focus() / app.focus(). When the OS hands off the URL without auto-activating the app, the window never comes forward. An explicit window raise in the handler would fix it.

Code Example

[info] Resume deep link: ... <uuid>
[info] [CCD] LocalSessions.setFocusedSession: sessionId=local_<uuid>
RAW_BUFFERClick to expand / collapse

Summary

When a claude:// deep link is delivered while Claude Desktop is already running and not frontmost, the handler navigates to the target internally but does not raise or focus the window. The navigation only becomes visible if the app is already the frontmost application. Earlier builds brought the window to the foreground in this case.

Environment

  • Claude Desktop 1.11187.1
  • macOS 15 (Darwin 24.6.0), Apple Silicon

Steps to reproduce

  1. Claude Desktop running, window not frontmost (another app in front).
  2. Have the URL delivered by a process that does not itself activate the target app (e.g. a foreground application handing off the custom scheme). Note: open "claude://…" from Terminal activates the app via LaunchServices and does not reproduce; the issue appears when the app must self-activate from its open-url handler.
  3. Example route: claude://resume?session=<uuid>.

Expected

Claude Desktop comes to the foreground.

Actual

The route is handled and focused internally, but the window is not raised; the previously frontmost app stays in front.

Evidence (~/Library/Logs/Claude/main1.log)

[info] Resume deep link: ... <uuid>
[info] [CCD] LocalSessions.setFocusedSession: sessionId=local_<uuid>

The deep link is received and the target is focused in the model, with no window activation.

Likely cause

The app.on("open-url", …) handler calls event.preventDefault() and dispatches navigation to the webContents without a corresponding window.show() / BrowserWindow.focus() / app.focus(). When the OS hands off the URL without auto-activating the app, the window never comes forward. An explicit window raise in the handler would fix it.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING