[waleedlatif1]

Summary

• Sim Desktop on macOS 15+ couldn't load a self-hosted server on a private address: ERR_ADDRESS_UNREACHABLE (-109). That's macOS Local Network privacy failing the socket with EHOSTUNREACH, not Chromium. Chromium's Local Network Access blocks report -36/-384/-385, never -109.
• Add NSLocalNetworkUsageDescription to the mac bundle so the system prompt says why Sim needs local network access
• Classify -109 on macOS as a new local_network load failure, and have the offline page tell the user to turn on Sim under System Settings > Privacy & Security > Local Network. Other platforms keep the generic unreachable copy.
• Supersedes fix(desktop): allow private self-hosted origins #9765: Chromium 150 (Electron 43) parses --ip-address-space-overrides entries only as ip:port or CIDR and silently drops hostnames, so that override never applied

Type of Change

• Bug fix

Testing

• load-health.test.ts: new -109 darwin/linux/win32 case, red against the pre-fix classifyLoadError, green with the fix
• bun run --cwd apps/desktop test (93 files, 1282 tests), desktop type-check, bun run lint
• Checked Chromium 150.0.7871.250's ip_address_space_util.cc and net_error_list.h, and confirmed with an Electron 43.8.1 script that the override switch only reaches the network service when it's appended synchronously at startup

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing (new tests pass the test-audit authoring gate)
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated
docs	Skipped		Nov 7, 2026 8:31pm UTC

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable issues were found.

Summary

Explains macOS Local Network blocks when Sim Desktop cannot reach a self-hosted server.

• The desktop explains when macOS blocks a private Sim server.

The latest revision adds the macOS version check. No new actionable issues were found. No previous review threads were supplied.

_{Reviews (2) · Last reviewed commit: "fix(desktop): only show Local Network gu..." · Reviewed by Greptile}

[cubic-dev-ai]

All reported issues were addressed across 4 files

<sub>Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic</sub>

[waleedlatif1]

@greptile

[waleedlatif1]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

No issues found across 4 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Turn on auto-fix | Re-trigger cubic}