Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[Bug] Desktop app crashes on launch after macOS 27 upgrade (DesktopLocalEnvironmentAuthSessionBootstrapError)

Open
  • Is something wrong?
#12,918 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
macos, typescript
Domain
authentication, desktop

Research direction

Start in apps/desktop by tracing the primary local environment bootstrap from the renderer beforeLoad path through the main-process /oauth/token exchange. Inspect how DesktopLocalEnvironmentAuthSessionBootstrapError reaches RootRouteErrorView, then reproduce with pnpm build:desktop && pnpm start:desktop. Done means a transient loopback failure is recovered from and the app reaches chat or pairing UI instead of crashing.

Written by the indexing model from the issue text.

Description

accepted bug via-triage
Area

apps/desktop

Steps to reproduce
  1. On macOS 27 (Build 26A428), build and launch the T3 Code desktop app (pnpm build:desktop && pnpm start:desktop).
  2. The app attempts to bootstrap the primary local environment on launch.
  3. The main-process /oauth/token exchange over loopback hits a transient failure (connection reset / brief 503 while the backend settles — newly common after the macOS 27 upgrade).
  4. The renderer crashes to the root error view during beforeLoad.
Expected behavior

The app boots to the chat view (or the pairing UI if unauthenticated), riding out the transient loopback failure.

Actual behavior

The app crashes to RootRouteErrorView with PrimaryEnvironmentRequestError caused by DesktopLocalEnvironmentAuthSessionBootstrapError: Failed to create the local desktop bearer session. No recovery path; relaunch may work if the transient condition has cleared.

Impact

Blocks work completely

Version or commit

main (pre-fix)

Environment

macOS 27.0 (Build 26A428), desktop app, Node v23.10.0

Logs or stack traces
PrimaryEnvironmentRequestError
  ← DesktopLocalEnvironmentAuthSessionBootstrapError: Failed to create the local desktop bearer session
  ← RemoteEnvironmentAuthUndeclaredStatusError (503) | RemoteEnvironmentAuthFetchError | TypeError
Workaround

Relaunch after the transient condition clears. No in-app recovery.

Dominant language
TypeScript
Stars
24.8k
Forks
6.4k
Avg merge
7h 14m
Merged PRs (30d)
201

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from pingdotgg/t3code

All issues in pingdotgg/t3code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.