RELIABILITY BRIEF · P2 · DESKTOP / RENDERING
Hermes macOS Tahoe Multi-Window Black Screen: Issue #68525
A sourced reliability brief on an open report that Hermes v0.19.0 New Window flows can render a black window on macOS 26 Tahoe while the peer renderer gateway connection hangs.
What the report says
The open issue reports that on macOS 26.5 Tahoe, both keyboard and File menu New Window paths in Hermes v0.19.0 produce a black window: window chrome appears, but React does not mount. The report notes stalled event-loop warnings and a peer-window renderer WebSocket connection to the gateway that hangs. It also reports no workaround because a single-instance lock prevents opening a second process.
Status boundary: This page summarizes a public, open issue report. It is not an independent reproduction, security assessment, product-wide reliability estimate, or confirmation that the report remains unresolved.
Operational significance
For affected desktop users, a multi-window workflow may be unavailable, with the severity depending on whether a second window is required for the task. This brief is a summary of an open report, not an independent validation of the stated root cause, platform coverage, or absence of workaround.
Evidence-bounded verification checklist
| Check | Question | Safe evidence practice |
|---|---|---|
| Platform and build | Is the client on the reported macOS version and Hermes build? | Capture exact OS, application build, and installation context. |
| Entry-path coverage | Do both New Window entry paths show the same behavior? | Test keyboard and menu paths separately using a non-production workspace. |
| Renderer state | Does the window chrome appear while application content fails to mount? | Use a time-bounded screen recording or screenshot with safe content. |
| Gateway connection | Do logs indicate a stalled or unsuccessful peer-window renderer connection? | Preserve redacted diagnostics and avoid inferring causality from one log line. |
| Fallback availability | Can the user continue safely in the original window or a supported alternative? | State tested alternatives and untested paths separately. |
Handling guidance
- Preserve client build, macOS version, timestamps, and safe screenshots before changing application state.
- Avoid destructive reinstall or data cleanup until user data and diagnostic artifacts are protected.
- Describe the failure as platform-specific and reported until reproduction confirms broader scope.
- Monitor the upstream issue for maintained workaround guidance and a versioned fix.
Source evidence
Hermes Agent GitHub issue #68525
Issue status, labels, discussion, and remediation guidance can change. Consult the upstream report directly before making deployment or product decisions.