Skip to content

Re-land Claude per-account folders (#24434, #26405) with the upgrade and proxy fixes - #26801

Merged
Jinwoo-H merged 9 commits into
mainfrom
claude-accounts-reland
Oct 9, 2026
Merged

Jinwoo-H merged 9 commits into
mainfrom
claude-accounts-reland

Conversation

@Jinwoo-H

@Jinwoo-H Jinwoo-H commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor
Files Added Deleted Net
Test 138 $\color{#1a7f37}{\Huge{\mathbf{+}}}$​3857 $\color{#cf222e}{\Huge{\mathbf{−}}}$​12610 $\color{#cf222e}{\Huge{\mathbf{−}}}$​8753
Prod 183 $\color{#1a7f37}{\Huge{\mathbf{+}}}$​2975 $\color{#cf222e}{\Huge{\mathbf{−}}}$​8159 $\color{#cf222e}{\Huge{\mathbf{−}}}$​5184

ELI5

This brings back Claude per-account folders (#24434, #26405), which were reverted in #26638 because they signed people out after updating and broke proxy setups. The fixes for those problems are in #26769, which merges into this branch. This PR is what lands on main once #26769 is in.

What Changed

Why

Saved Claude accounts used to work by copying login tokens into ~/.claude. Claude rotates those tokens, so the copies went stale and forced people to sign in again (STA-3698). Giving each account its own Claude folder lets Claude keep its own login fresh. The first landing missed the upgrade path and proxy setups; #26769 fixes both.

Linked Issue

STA-3698. Re-lands #24434 and #26405 after #26638.

Visual Proof

See #26769. The UI here only removes or narrows existing UI; no new wording.

Testing

See #26769. In a sandboxed macOS build with an isolated keychain and a proxy stub, both reported cases now work after updating with no sign-in: an account saved in the old build, and a proxy plus key in ~/.claude/settings.json. The proxy only ever saw its own key, and nothing touched a real ~/.claude or Keychain.

  • I manually tested these changes locally
  • Automated tests added/updated, or explained why not below

Review

Merge #26769 into this branch first. Two independent review rounds were done on #26769.

Agent skill upstream boundary

  • Not applicable, or this change copies or mechanically translates no upstream skill-installer source, tests, fixtures, registry entries, path tables, comments, or documentation.

Notes

  • Platforms: macOS, Linux, Windows and WSL follow the same rules.
  • SSH: remotes are unchanged.
  • Daemon protocol: goes to 44, with v42 and v43 still attachable.
  • CI: the src/main/ipc/app.ts max-lines failure comes from main (Warn on slow profile saves instead of failing them #26447) and isn't touched here.

Checklist

  • This PR is small and focused
  • I explained what changed and why (ELI5, the user-facing before/after, the mechanism, and why over the alternatives)
  • Before/after screenshots or videos attached for UI changes, or N/A with reason
  • Self-reviewed for correctness, security, and performance
  • Cross-platform, SSH/remote, and path/shortcut impact considered (or N/A)
  • pnpm lint, pnpm typecheck, pnpm test, and pnpm build pass (or CI will cover; local preferred)

…tion

v43 daemons (the revert) lack the claude account function, so new terminals must not reuse them. v42 and v43 stay attachable.
@Jinwoo-H
Jinwoo-H requested a review from brennanb2025 as a code owner October 9, 2026 08:03
# Conflicts:
#	src/main/claude/claude-structured-launch-resolution.ts
#	src/renderer/src/components/native-chat/NativeChatNoticeRow.tsx
#	src/renderer/src/components/native-chat/NativeChatStructuredSession.tsx
#	src/renderer/src/i18n/en-runtime-required.json
@coderabbitai

coderabbitai Bot commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 9f7c929f-b8b7-4ce5-a3ca-7f8a93e80fc3

📥 Commits

Reviewing files that changed from the base of the PR and between deada6d and a055fec.


⛔ Files ignored due to path filters (1)
  • src/shared/rpc-contract/rpc-params-catalog.generated.ts is excluded by !**/*.generated.*

📒 Files selected for processing (12)
  • src/main/daemon/daemon-provider-init.ts
  • src/main/daemon/daemon-provider-state.ts
  • src/renderer/src/components/status-bar/StatusBarProviderSegment.tsx
  • src/renderer/src/components/status-bar/StatusBarSurface.tsx
  • src/renderer/src/i18n/en-runtime-required.json
  • src/renderer/src/i18n/locales/en.json
  • src/renderer/src/i18n/locales/es.json
  • src/renderer/src/i18n/locales/fr.json
  • src/renderer/src/i18n/locales/ja.json
  • src/renderer/src/i18n/locales/ko.json
  • src/renderer/src/i18n/locales/zh.json
  • src/shared/wsl-login-shell-command.ts

🚧 Files skipped from review as they are similar to previous changes (6)
  • src/renderer/src/i18n/en-runtime-required.json
  • src/renderer/src/i18n/locales/ko.json
  • src/renderer/src/i18n/locales/es.json
  • src/renderer/src/i18n/locales/fr.json
  • src/renderer/src/i18n/locales/zh.json
  • src/renderer/src/i18n/locales/en.json

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 4 remain after this review.



📝 Walkthrough

Walkthrough

Claude account sign-in now uses dedicated profile folders and runtime APIs. Profile routing and setup support host and WSL accounts. Account listings, settings, native chat, and the status bar expose sign-in state. Usage fetching reads profile credentials. The changes also remove managed-auth synchronization and live-PTY refresh gating, and add detection and notices for terminals opened before per-account folders were introduced.


Priority: ➖ Normal

Merge Risk: ⚪ Minimal · up to a055f

No actionable merge-blocking issue is established; the change is mergeable after normal checks.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage Warning Docstring coverage is 47.56% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 82 functions across 56 files. (7 skipped:… Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check Passed The title clearly identifies the main change: re-landing Claude per-account folders with upgrade and proxy fixes.
Description check Passed The description is mostly complete and covers the user impact, changes, rationale, linked work, testing, platform considerations, review notes, and checklist. It references related PRs for visual proo…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 47.56% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 82 functions across 56 files. (7 skipped: 7 unsupported.)



✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Commit to this branch
  • Create a new PR


  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2


ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: eae53e32-9943-46b2-a190-2fccb9035e26
📥 Commits

Reviewing files that changed from the base of the PR and between df922d3 and c609386.

⛔ Files ignored due to path filters (1)
  • src/shared/rpc-contract/rpc-params-catalog.generated.ts is excluded by !**/*.generated.*
📒 Files selected for processing (267)
  • .github/workflows/pr.yml
  • config/scripts/claude-account-windows-spawn-repro.mjs
  • config/scripts/node-pty-windows-pty-teardown-patch.test.mjs
  • src/cli/handlers/account-list-format.ts
  • src/cli/handlers/account.test.ts
  • src/cli/handlers/account.ts
  • src/main/__fixtures__/shell-wrapper-snapshots/daemon-bash-rcfile.txt
  • src/main/__fixtures__/shell-wrapper-snapshots/daemon-fish-init.txt
  • src/main/__fixtures__/shell-wrapper-snapshots/daemon-zsh-zshenv.txt
  • src/main/__fixtures__/shell-wrapper-snapshots/local-bash-rcfile.txt
  • src/main/__fixtures__/shell-wrapper-snapshots/local-fish-init.txt
  • src/main/__fixtures__/shell-wrapper-snapshots/local-zsh-zshenv.txt
  • src/main/__fixtures__/shell-wrapper-snapshots/relay-zsh-zshenv.txt
  • src/main/agent-auth-restart-preservation.test.ts
  • src/main/agent-auth-restart-preservation.ts
  • src/main/claude-accounts/claude-account-folder.test.ts
  • src/main/claude-accounts/claude-account-folder.ts
  • src/main/claude-accounts/claude-account-registration.ts
  • src/main/claude-accounts/claude-account-selection.ts
  • src/main/claude-accounts/claude-account-service-account-selection.test.ts
  • src/main/claude-accounts/claude-account-service-add-account.test.ts
  • src/main/claude-accounts/claude-account-service-api-parity.test.ts
  • src/main/claude-accounts/claude-account-service-config-dir-capture.test.ts
  • src/main/claude-accounts/claude-account-service-credential-capture.test.ts
  • src/main/claude-accounts/claude-account-service-login-process.test.ts
  • src/main/claude-accounts/claude-account-service-reauth-rollback.test.ts
  • src/main/claude-accounts/claude-account-service-test-harness.ts
  • src/main/claude-accounts/claude-account-service.test.ts
  • src/main/claude-accounts/claude-auth-capture.ts
  • src/main/claude-accounts/claude-command-process.test.ts
  • src/main/claude-accounts/claude-command-process.ts
  • src/main/claude-accounts/claude-credential-persistence-ratchet.test.ts
  • src/main/claude-accounts/claude-login-completion.oracle.test.ts
  • src/main/claude-accounts/claude-login-session.ts
  • src/main/claude-accounts/claude-managed-auth-storage.ts
  • src/main/claude-accounts/claude-profile-installed-router.ts
  • src/main/claude-accounts/claude-profile-paths.test.ts
  • src/main/claude-accounts/claude-profile-paths.ts
  • src/main/claude-accounts/claude-profile-provisioning.test.ts
  • src/main/claude-accounts/claude-profile-provisioning.ts
  • src/main/claude-accounts/claude-profile-router.test.ts
  • src/main/claude-accounts/claude-profile-router.ts
  • src/main/claude-accounts/claude-profile-setup.test.ts
  • src/main/claude-accounts/claude-profile-setup.ts
  • src/main/claude-accounts/claude-profile-shell-composition.test.ts
  • src/main/claude-accounts/claude-profile-wsl-paths.ts
  • src/main/claude-accounts/claude-profile-wsl-router.test.ts
  • src/main/claude-accounts/claude-profile-wsl-router.ts
  • src/main/claude-accounts/claude-windows-interactive-login.test.ts
  • src/main/claude-accounts/environment.ts
  • src/main/claude-accounts/keychain.test.ts
  • src/main/claude-accounts/keychain.ts
  • src/main/claude-accounts/live-pty-gate.test.ts
  • src/main/claude-accounts/live-pty-gate.ts
  • src/main/claude-accounts/managed-auth-path.ts
  • src/main/claude-accounts/oauth-refresh.test.ts
  • src/main/claude-accounts/oauth-refresh.ts
  • src/main/claude-accounts/runtime-auth-path-materialization.test.ts
  • src/main/claude-accounts/runtime-auth-service-account-switching.test.ts
  • src/main/claude-accounts/runtime-auth-service-deselect-restore.test.ts
  • src/main/claude-accounts/runtime-auth-service-keychain-snapshots.test.ts
  • src/main/claude-accounts/runtime-auth-service-launch-refresh.test.ts
  • src/main/claude-accounts/runtime-auth-service-materialization.test.ts
  • src/main/claude-accounts/runtime-auth-service-readback-identity.test.ts
  • src/main/claude-accounts/runtime-auth-service-shared-credential-failures.test.ts
  • src/main/claude-accounts/runtime-auth-service-shared-credentials.test.ts
  • src/main/claude-accounts/runtime-auth-service-snapshot-validation.test.ts
  • src/main/claude-accounts/runtime-auth-service-test-harness.ts
  • src/main/claude-accounts/runtime-auth-service-wsl-runtime.test.ts
  • src/main/claude-accounts/runtime-auth-service.test.ts
  • src/main/claude-accounts/runtime-auth-service.ts
  • src/main/claude-accounts/runtime-auth-shared-credentials-fixture.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-credential-identity.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-credential-matching.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-file-storage.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-keychain-snapshots.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-managed-credentials.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-preparation.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-readback.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-runtime-state.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-snapshot-capture.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-snapshot-restore.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-state.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-sync.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-types.ts
  • src/main/claude-accounts/runtime-paths.test.ts
  • src/main/claude-accounts/runtime-paths.ts
  • src/main/claude-accounts/service.ts
  • src/main/claude-accounts/shared-credential-fields.test.ts
  • src/main/claude-accounts/shared-credential-fields.ts
  • src/main/claude-accounts/shared-credential-reconciliation.test.ts
  • src/main/claude/claude-model-catalog-probe.ts
  • src/main/claude/claude-stream-json-connection.test.ts
  • src/main/claude/claude-stream-json-connection.ts
  • src/main/claude/claude-structured-auth-parity.test.ts
  • src/main/claude/claude-structured-effort-default-at-rest.test.ts
  • src/main/claude/claude-structured-launch-account-routing.test.ts
  • src/main/claude/claude-structured-launch-home.ts
  • src/main/claude/claude-structured-launch-resolution.test.ts
  • src/main/claude/claude-structured-launch-resolution.ts
  • src/main/claude/claude-structured-session-acquisition.ts
  • src/main/daemon/daemon-foreground-confirmation-protocol.test.ts
  • src/main/daemon/daemon-init-provider-installation.test.ts
  • src/main/daemon/daemon-protocol-version.ts
  • src/main/daemon/daemon-provider-init.ts
  • src/main/daemon/daemon-provider-state.ts
  • src/main/daemon/pty-subprocess/shell-launch-plan.ts
  • src/main/ipc/claude-accounts.ts
  • src/main/ipc/pty-listener-teardown-and-orphans.test.ts
  • src/main/ipc/pty-spawn-env-terminal-basics.test.ts
  • src/main/ipc/pty/ipc/claude-old-terminal.test.ts
  • src/main/ipc/pty/ipc/claude-old-terminal.ts
  • src/main/ipc/pty/ipc/spawn-commit.ts
  • src/main/ipc/pty/ipc/spawn-env.ts
  • src/main/ipc/pty/ipc/spawn-preflight.ts
  • src/main/ipc/pty/provider/bind-listeners.ts
  • src/main/ipc/pty/provider/liveness.ts
  • src/main/ipc/pty/provider/local-configure.ts
  • src/main/ipc/pty/provider/state-cleanup.ts
  • src/main/ipc/pty/register-handlers.ts
  • src/main/ipc/pty/runtime/spawn-commit.ts
  • src/main/ipc/pty/runtime/spawn-preflight-requested-shell.test.ts
  • src/main/ipc/pty/runtime/spawn-preflight.ts
  • src/main/macos-keychain/generic-password.test.ts
  • src/main/macos-keychain/generic-password.ts
  • src/main/native-chat/agent-session-wire/structured-agent-session-adapter.ts
  • src/main/native-chat/agent-session-wire/structured-agent-session-failure-text.ts
  • src/main/native-chat/agent-session-wire/structured-agent-session-pre-spawn-first-answer.test.ts
  • src/main/native-chat/agent-session-wire/structured-agent-session-queued-mutations.ts
  • src/main/native-chat/claude-structured-managed-account-support.test.ts
  • src/main/native-chat/claude-structured-managed-account-support.ts
  • src/main/native-chat/structured-agent-session-create-support.test.ts
  • src/main/native-chat/structured-agent-session-create-support.ts
  • src/main/persistence-worktree-lineage-and-backups.test.ts
  • src/main/persistence/leasing-ssh-ptys/ssh-target-state.ts
  • src/main/persistence/loading-store/normalize-loaded-profile-state.ts
  • src/main/persistence/loading-store/profile-state-direct-flush.test.ts
  • src/main/persistence/loading-store/ssh-profile-operations.ts
  • src/main/persistence/loading-store/store-domain-composition.ts
  • src/main/persistence/restoring-sessions/pane-alias-normalization.ts
  • src/main/providers/local-pty-windows-spawn-environment.ts
  • src/main/providers/windows-shell-args.test.ts
  • src/main/providers/windows-shell-args.ts
  • src/main/rate-limits/claude-active-usage-fetch.ts
  • src/main/rate-limits/claude-cli-usage-fetch.ts
  • src/main/rate-limits/claude-fetcher-cli-fallback.test.ts
  • src/main/rate-limits/claude-fetcher-fable-usage.test.ts
  • src/main/rate-limits/claude-fetcher-keychain-credentials.test.ts
  • src/main/rate-limits/claude-fetcher-managed-account-usage.test.ts
  • src/main/rate-limits/claude-fetcher-test-harness.ts
  • src/main/rate-limits/claude-fetcher.ts
  • src/main/rate-limits/claude-managed-account-credentials.ts
  • src/main/rate-limits/claude-managed-account-usage.ts
  • src/main/rate-limits/claude-managed-usage-panel.ts
  • src/main/rate-limits/claude-oauth-credentials.ts
  • src/main/rate-limits/claude-oauth-recovery.ts
  • src/main/rate-limits/claude-oauth-usage-extra-usage.test.ts
  • src/main/rate-limits/claude-profile-usage.test.ts
  • src/main/rate-limits/claude-pty-reset-parser.ts
  • src/main/rate-limits/claude-pty-stop-markers.ts
  • src/main/rate-limits/claude-pty-usage-parser.ts
  • src/main/rate-limits/claude-pty.test.ts
  • src/main/rate-limits/claude-pty.ts
  • src/main/rate-limits/claude-usage-error-classification.test.ts
  • src/main/rate-limits/claude-usage-error-classification.ts
  • src/main/rate-limits/claude-usage-refresh-plan.test.ts
  • src/main/rate-limits/claude-usage-refresh-plan.ts
  • src/main/rate-limits/claude-usage-result.ts
  • src/main/rate-limits/hidden-pty-cleanup.test.ts
  • src/main/rate-limits/hidden-pty-cleanup.ts
  • src/main/rate-limits/service-account-target-selection.test.ts
  • src/main/rate-limits/service-inactive-account-previews.test.ts
  • src/main/rate-limits/service-live-claude-usage.test.ts
  • src/main/rate-limits/service/service-account-refresh.ts
  • src/main/rate-limits/service/service-fetch-policy.ts
  • src/main/runtime/orca-runtime-get-structured-agent-session-create-support.ts
  • src/main/runtime/orca-runtime-get-worktree-ps.ts
  • src/main/runtime/orca-runtime-structured-claude-account-gate.test.ts
  • src/main/runtime/orca-runtime-structured-claude-gate-wiring.test.ts
  • src/main/runtime/rpc/methods/accounts.test.ts
  • src/main/runtime/rpc/methods/accounts.ts
  • src/main/runtime/runtime-account-controller.ts
  • src/main/runtime/runtime-service-command-surface.ts
  • src/main/runtime/structured-agent-create-support-opencode-rig.test.ts
  • src/main/runtime/structured-agent-launch-support.ts
  • src/main/runtime/structured-agent-runtime-registrations.ts
  • src/main/runtime/structured-agent-session-runtime.ts
  • src/main/runtime/structured-claude-runtime-adapter.ts
  • src/main/shell-wrapper-generated-file-snapshot.test.ts
  • src/main/startup/main-process-account-services.ts
  • src/main/startup/main-process-ready-foundation.ts
  • src/main/startup/main-process-ready-identity-write.test.ts
  • src/main/startup/main-window-core-services.test.ts
  • src/main/startup/main-window-core-services.ts
  • src/preload/api/pty-api.ts
  • src/preload/api/pty-bridge-stream-and-serialization.ts
  • src/renderer/src/app-shell/use-app-shell-services.ts
  • src/renderer/src/components/native-chat/NativeChatNoticeRow.tsx
  • src/renderer/src/components/native-chat/NativeChatStructuredSession.tsx
  • src/renderer/src/components/native-chat/agent-session-failure-words-text.ts
  • src/renderer/src/components/native-chat/native-chat-claude-sign-in.test.tsx
  • src/renderer/src/components/native-chat/native-chat-claude-sign-in.ts
  • src/renderer/src/components/native-chat/native-chat-structured-session-notices.ts
  • src/renderer/src/components/settings/accounts-pane-account-actions.ts
  • src/renderer/src/components/settings/accounts-pane-claude-section.test.tsx
  • src/renderer/src/components/settings/accounts-pane-claude-section.tsx
  • src/renderer/src/components/settings/accounts-pane-removal-dialogs.tsx
  • src/renderer/src/components/status-bar/ClaudeSwitcherMenu.tsx
  • src/renderer/src/components/status-bar/InlineProviderUsage.tsx
  • src/renderer/src/components/status-bar/StatusBarProviderSegment.tsx
  • src/renderer/src/components/status-bar/StatusBarSurface.tsx
  • src/renderer/src/components/status-bar/claude-status-sign-in.test.tsx
  • src/renderer/src/components/status-bar/inline-usage-bars.test.tsx
  • src/renderer/src/components/status-bar/status-bar-claude-accounts.ts
  • src/renderer/src/components/status-bar/status-bar-runtime-groups.test.ts
  • src/renderer/src/components/status-bar/status-bar-runtime-targets.ts
  • src/renderer/src/components/status-bar/tooltip.test.ts
  • src/renderer/src/components/status-bar/usage-error-copy.ts
  • src/renderer/src/components/status-bar/usage-provider-settings-target.test.ts
  • src/renderer/src/components/status-bar/usage-provider-settings-target.ts
  • src/renderer/src/components/status-bar/usage-roster-row-state.test.ts
  • src/renderer/src/components/status-bar/use-status-bar-controller.ts
  • src/renderer/src/components/terminal-pane/ClaudeOldTerminalBanner.tsx
  • src/renderer/src/components/terminal-pane/CodexOldTerminalDialog.tsx
  • src/renderer/src/components/terminal-pane/CodexSharedServerBanner.tsx
  • src/renderer/src/components/terminal-pane/OldTerminalDialog.tsx
  • src/renderer/src/components/terminal-pane/PaneTopWarningBanner.tsx
  • src/renderer/src/components/terminal-pane/TerminalPaneRuntimePortals.tsx
  • src/renderer/src/components/terminal-pane/claude-old-terminal-banner.test.tsx
  • src/renderer/src/components/terminal-pane/open-terminal-beside-tab.ts
  • src/renderer/src/i18n/en-runtime-required.json
  • src/renderer/src/i18n/locales/en.json
  • src/renderer/src/i18n/locales/es.json
  • src/renderer/src/i18n/locales/fr.json
  • src/renderer/src/i18n/locales/ja.json
  • src/renderer/src/i18n/locales/ko.json
  • src/renderer/src/i18n/locales/zh.json
  • src/renderer/src/lib/claude-account-sign-in-notice.test.ts
  • src/renderer/src/lib/claude-account-sign-in-notice.ts
  • src/renderer/src/lib/claude-account-sign-in.ts
  • src/renderer/src/store/slices/ui-notice-dismissals.test.ts
  • src/renderer/src/store/slices/ui/ui-slice-contract-contextual.ts
  • src/renderer/src/store/slices/ui/ui-slice-hydration-actions.ts
  • src/renderer/src/store/slices/ui/ui-slice-trust-actions.ts
  • src/renderer/src/web/preload-api/web-terminal-api.ts
  • src/shared/agent-session-failure-copy.ts
  • src/shared/agent-session-failure-words.ts
  • src/shared/agent-session-failure.ts
  • src/shared/agent-session-refusal-details.ts
  • src/shared/agent-session-refusal-reason-words.ts
  • src/shared/claude-profile-activation-contract.test.ts
  • src/shared/claude-profile-routing.ts
  • src/shared/claude-shell-function.test.ts
  • src/shared/claude-shell-function.ts
  • src/shared/constants.ts
  • src/shared/global-settings-types.ts
  • src/shared/local-build-compatibility-contract.json
  • src/shared/local-build-compatibility-contract.ts
  • src/shared/managed-account-types.ts
  • src/shared/persisted-state-types.ts
  • src/shared/persisted-ui-state-types.ts
  • src/shared/protocol-version.ts
  • src/shared/rate-limit-types.ts
  • src/shared/rpc-contract/accounts-params.ts
  • src/shared/rpc-contract/client-ui-params.ts
  • src/shared/structured-agent-session-dispatch-rejection.ts
  • src/shared/wsl-login-shell-command.ts
💤 Files with no reviewable changes (86)
  • src/main/claude-accounts/claude-account-service-login-process.test.ts
  • src/main/claude-accounts/runtime-auth-service-wsl-runtime.test.ts
  • src/main/claude-accounts/runtime-auth-service-materialization.test.ts
  • src/main/native-chat/claude-structured-managed-account-support.test.ts
  • src/main/claude-accounts/claude-account-service-config-dir-capture.test.ts
  • src/main/claude-accounts/claude-account-service-add-account.test.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-keychain-snapshots.ts
  • src/shared/constants.ts
  • src/main/runtime/orca-runtime-get-worktree-ps.ts
  • src/main/startup/main-process-account-services.ts
  • src/main/claude-accounts/shared-credential-fields.test.ts
  • src/main/claude-accounts/claude-account-service-credential-capture.test.ts
  • src/main/claude-accounts/oauth-refresh.test.ts
  • src/main/claude-accounts/runtime-auth-service-keychain-snapshots.test.ts
  • src/main/claude/claude-stream-json-connection.test.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-preparation.ts
  • src/main/ipc/pty-listener-teardown-and-orphans.test.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-runtime-state.ts
  • src/main/claude-accounts/claude-account-service-account-selection.test.ts
  • src/main/claude-accounts/runtime-auth-service-readback-identity.test.ts
  • src/main/claude-accounts/shared-credential-reconciliation.test.ts
  • src/main/claude-accounts/claude-account-service-test-harness.ts
  • config/scripts/claude-account-windows-spawn-repro.mjs
  • src/main/ipc/pty/runtime/spawn-commit.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-state.ts
  • src/main/claude-accounts/claude-account-service-api-parity.test.ts
  • src/main/persistence/loading-store/profile-state-direct-flush.test.ts
  • src/main/claude-accounts/runtime-auth-service-launch-refresh.test.ts
  • src/main/claude/claude-stream-json-connection.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-credential-identity.ts
  • src/main/claude/claude-model-catalog-probe.ts
  • src/main/daemon/daemon-init-provider-installation.test.ts
  • src/main/claude-accounts/runtime-auth-shared-credentials-fixture.ts
  • src/main/claude-accounts/claude-account-service-reauth-rollback.test.ts
  • src/shared/rate-limit-types.ts
  • src/main/startup/main-window-core-services.test.ts
  • src/main/claude-accounts/runtime-paths.test.ts
  • src/main/ipc/pty/ipc/spawn-commit.ts
  • src/main/native-chat/agent-session-wire/structured-agent-session-queued-mutations.ts
  • src/main/ipc/pty/provider/state-cleanup.ts
  • src/main/persistence-worktree-lineage-and-backups.test.ts
  • src/main/runtime/structured-agent-runtime-registrations.ts
  • src/main/startup/main-process-ready-identity-write.test.ts
  • src/main/ipc/pty/provider/local-configure.ts
  • src/main/ipc/pty/runtime/spawn-preflight.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-managed-credentials.ts
  • src/main/claude-accounts/runtime-auth-service-snapshot-validation.test.ts
  • src/main/claude-accounts/live-pty-gate.test.ts
  • src/main/claude-accounts/runtime-auth-service-test-harness.ts
  • src/main/ipc/pty/provider/liveness.ts
  • src/main/claude-accounts/runtime-auth-service-account-switching.test.ts
  • src/main/claude-accounts/runtime-auth-service-deselect-restore.test.ts
  • src/main/ipc/pty/ipc/spawn-preflight.ts
  • src/main/rate-limits/service/service-account-refresh.ts
  • src/main/ipc/pty/provider/bind-listeners.ts
  • src/main/claude-accounts/claude-login-completion.oracle.test.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-file-storage.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-snapshot-capture.ts
  • src/main/persistence/loading-store/normalize-loaded-profile-state.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-snapshot-restore.ts
  • src/main/claude-accounts/runtime-auth-path-materialization.test.ts
  • src/main/claude-accounts/runtime-paths.ts
  • src/main/claude-accounts/runtime-auth-service-shared-credentials.test.ts
  • src/main/rate-limits/claude-usage-error-classification.ts
  • src/main/claude-accounts/claude-windows-interactive-login.test.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-credential-matching.ts
  • src/main/native-chat/claude-structured-managed-account-support.ts
  • src/main/ipc/pty/ipc/spawn-env.ts
  • src/main/persistence/restoring-sessions/pane-alias-normalization.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-readback.ts
  • src/main/macos-keychain/generic-password.ts
  • src/main/claude-accounts/claude-managed-auth-storage.ts
  • src/main/claude-accounts/runtime-auth-service-shared-credential-failures.test.ts
  • src/main/daemon/daemon-provider-init.ts
  • src/main/runtime/structured-agent-session-runtime.ts
  • src/main/rate-limits/claude-cli-usage-fetch.ts
  • src/main/persistence/leasing-ssh-ptys/ssh-target-state.ts
  • src/main/startup/main-process-ready-foundation.ts
  • src/main/claude-accounts/claude-auth-capture.ts
  • src/main/claude-accounts/runtime-auth/runtime-auth-sync.ts
  • src/main/claude-accounts/live-pty-gate.ts
  • src/main/runtime/structured-claude-runtime-adapter.ts
  • src/main/claude-accounts/shared-credential-fields.ts
  • src/main/claude-accounts/oauth-refresh.ts
  • src/main/claude-accounts/managed-auth-path.ts
  • src/shared/persisted-state-types.ts

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 8 remain after this review.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to GitHub limitations.

⚠️ Outside diff range comments (1)

🟠 Major · Restore the auth-switch gate before starting a… · claude-structured-session-acquisition.ts:61-63

src/main/claude/claude-structured-session-acquisition.ts:61-63
🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Restore the auth-switch gate before starting a structured acquisition.

A session started during an account switch can resolve inherited Claude authentication for the old selection, then resolve the config directory for the new selection. The child can therefore use the wrong account credentials or fail authentication. Restore the pre-spawn check at this acquisition boundary.

Suggested fix
-import type {
+import {
+  AgentSessionPreSpawnError,
+  type
   AgentSessionAcquisition,
   StructuredAgentSessionAcquireInput
 } from '../native-chat/agent-session-wire/structured-agent-session-adapter'
+import { CLAUDE_AUTH_SWITCH_IN_PROGRESS_MESSAGE } from '../claude-accounts/environment'
+import { isClaudeAuthSwitchInProgress } from '../claude-accounts/live-pty-gate'
 import { openClaudeStreamJsonConnection } from './claude-stream-json-connection'
@@
 }): Promise<AgentSessionAcquisition> {
+  if (isClaudeAuthSwitchInProgress()) {
+    throw new AgentSessionPreSpawnError(new Error(CLAUDE_AUTH_SWITCH_IN_PROGRESS_MESSAGE), {
+      reason: 'accountSwitchInProgress'
+    })
+  }
   const sessionId = input.identity.sessionId

ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 94d64b31-e2f1-4e84-8816-731047eef3a5
📥 Commits

Reviewing files that changed from the base of the PR and between 85f0216 and b862fc4.

⛔ Files ignored due to path filters (1)
  • src/shared/rpc-contract/rpc-params-catalog.generated.ts is excluded by !**/*.generated.*
📒 Files selected for processing (8)
  • src/main/claude/claude-model-catalog-probe.ts
  • src/main/claude/claude-structured-effort-default-at-rest.test.ts
  • src/main/claude/claude-structured-session-acquisition.ts
  • src/main/native-chat/agent-session-wire/structured-agent-session-adapter.ts
  • src/main/runtime/structured-agent-runtime-registrations.ts
  • src/main/runtime/structured-claude-runtime-adapter.ts
  • src/main/startup/main-process-account-services.ts
  • src/renderer/src/app-shell/use-app-shell-services.ts
💤 Files with no reviewable changes (5)
  • src/main/runtime/structured-agent-runtime-registrations.ts
  • src/main/startup/main-process-account-services.ts
  • src/main/claude/claude-model-catalog-probe.ts
  • src/main/runtime/structured-claude-runtime-adapter.ts
  • src/main/claude/claude-structured-session-acquisition.ts

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 0 remain after this review.

Jinwoo-H and others added 3 commits October 9, 2026 14:27
# Conflicts:
#	src/main/daemon/daemon-provider-init.ts
#	src/main/daemon/daemon-provider-state.ts
#	src/shared/wsl-login-shell-command.ts
… accounts mirror ~/.claude (#26769)

* Run a Claude account on System default until it has its own login

An account saved before per-account folders has no login in its folder. While System default (~/.claude, or the user's own CLAUDE_CONFIG_DIR) is signed in to the same email, the router sends every launch there and writes that choice into the pointer file, so nobody is logged out by the update. Once the account signs in to its own folder, the next launch uses it. The WSL router follows the same rule with the guest's ~/.claude.

* Refresh each Claude account folder from ~/.claude before every launch

~/.claude (or the user's own CLAUDE_CONFIG_DIR) is now the master copy. Each account folder gets its whole settings.json, including the proxy address and its key, and every .claude.json key except the login, Claude's account caches and install ids, so first-run questions are not asked again. Every other top-level entry is linked (folders) or copied (files), except Claude's per-folder daemon, jobs, live sessions, login files and throwaways. sessions is no longer shared, and an earlier link is undone.

The refresh runs before every Claude Orca starts, for each new terminal and on account switch. Orca never writes back to ~/.claude. The ledger that tracked selective sharing is gone.

* Route chat auth and unselected-account usage through the Claude router

Chats decided whether to drop inherited Anthropic auth from the selection alone, so an account running on System default lost the user's own key. They now ask the router, as terminals, AI commit messages, automations and usage already do. Usage for an unselected account is read where its launches would run. A test reads every entry point through the fallback and fails if a launch path outside the router reads the Claude selection or builds an account folder. The router's two launch errors move to their own file to keep it under the line limit.

* Show Claude account sign-in prompts only when an account cannot run

With the fallback, an account System default is signed in to already works, so:
- The one-time "Finish setting up your Claude accounts" toast is gone.
- Accounts System default covers no longer need a sign-in: no Sign in in the status bar menu or Settings, and they can be selected.
- The old-terminal banner shows only when claude in that terminal would run a different account than the selected one, and asks again after a switch. Its wording is unchanged.

The retired toast's saved flag stays in the paired-client schema so an older client's write is still accepted. The email comparison moves beside the login reader to keep the router under the line limit.

* Keep the user's shell Anthropic auth on Claude account launches

A signed-in account's launches used to drop ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN and CLAUDE_CODE_OAUTH_TOKEN from the inherited environment while ANTHROPIC_BASE_URL passed through, so a proxy set in the shell got the subscription login and answered 401. Host launches on an account now keep the shell's auth with its address, as System default does. Chats still name the account kind in a failed sign-in, now from the router rather than from whether auth was dropped.

* Share from ~/.claude only what Claude itself would seed into a new folder

The deny list missed much of Claude's runtime state, so tokens, locks and live files such as .session_ingress_token, server-sessions.json and remote-control were copied or linked over each account's own every launch. The list now mirrors the one Claude uses when it seeds a fresh config folder from ~/.claude: its runtime entries, every hidden entry, daemon files and agent memory. teams, ide, downloads and scratch are on it, so they stay per folder.

* Merge trusted folders and MCP servers into an account instead of replacing them

Each refresh replaced the account's projects and mcpServers with ~/.claude's, so folder trust and allowed tools recorded only in the account were lost, and a refresh landing between Orca's folder-trust write and Claude's start brought the trust dialog back. Both are now merged per folder path or server name: ~/.claude wins for entries it has, the account keeps the rest, and a folder trusted in the account stays trusted. Both writers take Claude's lock on the file, so the order no longer matters.

* Require the same organization before System default stands in for an account

The fallback compared emails only, so one email saved for two organizations made both accounts run on whichever organization System default was signed in to. When the saved account and System default's login both name an organization, it must now match too, on the host and in WSL, and the old-terminal banner uses the same comparison. The saved-account lookup the three checks repeated is now one helper.

* Treat v42 terminals as having the claude account function

v42 daemons shipped the same claude function and pointer path as v44, so claude in those terminals already follows the selected account. The old-terminal banner now shows only for daemons before v42 and for v43, the revert, which dropped the function.

* Fail the routing test when a new module resolves the claude binary

The census only caught code that read the Claude selection, not a new launcher that runs claude without asking the router. A second check now lists every module that resolves the claude binary or loads the Agent SDK, each with why it is routed, and fails on any new one, or on a listed one that no longer matches.

* Skip the account refresh on launches that run on System default

A launch that falls back to System default never uses the account folder, so starting a setup for it on every launch was wasted work. Account switches still set the folder up for a later sign-in.

* Give a terminal opened before the login shell's env only the account pointer

At startup, a pane could be routed before the login shell reported the user's own CLAUDE_CONFIG_DIR, so the fallback compared against ~/.claude.json instead. Until that env arrives a pane gets only the pointer, and the pointer is rewritten once it does, so claude typed there reads the right folder. The recent claude --version answer moves beside the version probe to keep the router under the line limit.

* Drop the chat-only Anthropic auth stripping and override refusal

Chats no longer drop the shell's Anthropic auth on any account, so the chat launch's override refusal and the policy's stripAuthEnv could only be reached from test fixtures. The structured auth policy is now just which login a failed sign-in names. Terminals keep their refusal, which still guards WSL launches; the failure reason stays in the shared vocabulary for older peers.

* Publish a new account state file whole

The first .claude.json write went straight to the target, so a crash mid-write could leave Claude a truncated state file. It is now written to a staged file and linked into place without replacing one Claude created meanwhile.

* Read an unselected WSL account's usage where the WSL router would run it

Usage for an unselected WSL account read its saved folder directly, so an account the guest's ~/.claude covers showed no usage, and the read bypassed the router. It now asks the WSL router, after the same check that the distro is already running.

* Keep the shell's Anthropic auth when the claude function runs an account

The claude shell function (POSIX, fish and PowerShell) unset ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, AWS_BEARER_TOKEN_BEDROCK and auth-like ANTHROPIC_CUSTOM_HEADERS before running Claude in an account folder, so a proxy set in the shell lost its key while keeping its address. It now only sets CLAUDE_CONFIG_DIR and Orca's marker, as on System default. Protocol 44 is unreleased, so no new bump; the shell-wrapper snapshots are regenerated.

* Never drop the user's Anthropic auth from a Claude launch

Orca's launches stripped ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, AWS_BEARER_TOKEN_BEDROCK and auth-like ANTHROPIC_CUSTOM_HEADERS for WSL terminals, terminal splits and through the preparation's stripAuthEnv flag, and refused a launch whose agent env set them. If the user's shell overrides the login, that is their setup: every launch now keeps it, on accounts, System default and WSL alike. The flag, the strip paths and the override refusal are gone; the refusal's reason stays in the shared vocabulary so older peers still decode it.

Orca's own process env and the claude --version probe still drop these variables: they are Orca's, not the user's launch.

* Leave out of an account's state everything Claude resets when it signs out

The .claude.json copy left out the login and keys matching cache patterns, but still carried account state such as additionalModelOptionsAnsweredAt, artifactRosterDenied, lastSeenOrgDefaultUpdatedAt and the subscription notices. The copy now leaves out the exact keys Claude resets on logout, beside the install ids, Console API key and first-token date; the cache patterns stay for account caches logout does not reset. Onboarding is still copied.

* Judge an old terminal's Claude banner by the pane's own runtime

The banner compared every old pane with the host selection and showed whenever only a WSL account was selected, so old host panes showed it with nothing to say and old WSL panes were judged by the host's account. The pane now names its runtime: a host pane is compared with the host selection, a WSL pane with its distro's selection through the WSL router, and a pane whose runtime is unknown, or with no account selected for it, stays hidden.

* Leave an account's settings file alone when only Orca's hooks differ from the default home's

* Reread a WSL account's Claude state only when the file changes

* Move tests merged from main onto the account-only Claude auth policy
# Conflicts:
#	src/main/text-generation/commit-message-agent-environment.ts
@Jinwoo-H
Jinwoo-H merged commit 8b2a5e4 into main Oct 9, 2026
55 of 57 checks passed
brennanb2025 added a commit that referenced this pull request Oct 10, 2026
It only types the chat command resolver it injects; main's launch-routing guard (#26801) matched the name.
brennanb2025 added a commit that referenced this pull request Oct 14, 2026
…#26464)

* fix: refresh host environments before structured agent command resolution

* fix: ship the owning server CLI for managed remote agents

* test: include the shipped CLI in remote install fixtures

* Bind packaged agent CLI calls to their execution host

* Keep owning-server CLI binding scoped to managed agents

* Serve the last shell environment to chat starts and refresh it in the background

Only the first chat start waits for the login shell; later starts get the last
snapshot and refresh it in the background once it is 10 s old. On Windows hosts
without the registry addon (managed server slots), the saved PATH is reread
with reg.exe. The Windows server CLI launcher stager now checks the target
architecture, and the CLI help says ambient selectors are ignored inside a
managed server.

* Keep the last good shell environment when a refresh fails, and load the Windows profile once

A login-shell capture now says whether the shell produced the env or Orca fell back
to its own, and only a real capture replaces the snapshot. Windows loads the
PowerShell profile once per process and refreshes only the saved PATH. The reg.exe
fallback queries the whole key so a missing user Path no longer drops the saved PATH.
The first capture starts when the resolvers are created.

* Keep the last good login-shell env for other readers while a forced refresh runs

* Mark the Claude launch resolver as a reviewed router-aware module

It only types the chat command resolver it injects; main's launch-routing guard (#26801) matched the name.

* Keep a settled login-shell env for readers during a refresh and share the first run

- Any settled cached entry, a fallback included, now serves other readers while a forced capture
  runs; only a real capture replaces it.
- Native chat's first capture shares a run a startup reader already began, so the login shell
  runs once per process at startup on macOS/Linux.
- Type the injected Claude resolver without naming resolveClaudeCommand.
- Cover the runtime's Claude command options, the owning-host --host check, and the PTY flag drop.

* Drop an inherited owning-host flag from daemon terminal panes

The persistent terminal daemon merges its own environment into every pane, so an inherited
ORCA_CLI_OWNING_HOST reached desktop panes even though main strips it from the spawn env.
Drop it with the other per-launch CLI variables.

* Route agents to their own server through ordinary launch defaults; start the first chat after an install

The native-chat agent environment now sets the owning server's ORCA_USER_DATA_PATH and
empty ORCA_ENVIRONMENT / ORCA_PAIRING_CODE / ORCA_REMOTE_PAIRING, which the CLI already
reads as unset; empty rather than deleted, because the spawn merges the launch overlay
over the server's own env. The ORCA_CLI_OWNING_HOST flag, the CLI's skip of ambient
selectors, the launchers' export of it, the terminal clean-up, the help-text exception
and the WSL launcher guard are gone, so a person's terminal follows their own settings
as on main.

A launch that finds no program in the shell snapshot waits for one shared refresh (at
most one shell timeout) and resolves again; create support rereads the shell once
before refusing. On Windows a failed PowerShell profile load is retried on the next
refresh instead of being kept until restart.

* One shared shell reread when an agent's program is missing

The pre-create check for OpenCode, OMP and Pi forced its own login-shell
capture on every refusal: not shared with launches, one per concurrent
check, triggered by an installed-but-too-old version too, and an older
capture finishing last could overwrite a newer cached environment. On
Windows, every launch miss also reran a failed PowerShell profile load,
bypassing the 10-second limit.

- One saved shell environment per host: chat launches, their misses, the
  pre-create check and AI commit messages read it and share one refresh.
- The pre-create check resolves the agent's program the way a launch does,
  so only a missing program waits for the refresh; registrations declare
  how to resolve their launch and check its version.
- A forced login-shell capture joins one already running for the same
  shell, so captures cannot land out of order.
- On Windows, a miss within 10 s of a failed PowerShell load rereads only
  the saved PATH.

* One owner for the cached shell environment

Review found two more races in the reread-on-miss machinery, both from the
host wrapper keeping its own snapshot beside the login-shell cache:
- A launch that found no program could join a reread that started before the
  agent was installed, and spend its one retry on the old PATH.
- On Windows, saved-PATH rereads renewed the snapshot's age, so a failed
  PowerShell profile was never retried while launches kept missing.

The login-shell cache is now the only owner of the captured environment, the
run in progress and which result wins (the newest run started; a fallback
never replaces a captured env). It takes three options instead of `force`:
- startedAfter: a lookup that found nothing waits for a run that started no
  earlier than the lookup did, joining one if it has, else starting one.
- refreshAfterMs: serve the last result and rerun in the background once the
  last attempt is older.
- keepCaptured: a captured env is kept for good; only a fallback is rerun
  (Windows' PowerShell profile).

The host wrapper keeps only policy: the 10 s interval, on Windows the saved
PATH laid over the profile env on every read (a miss forces a fresh registry
read), and the settings overlays. Its snapshot, pending promise, staleness and
Windows "loaded" bookkeeping are gone. A lookup's start time travels with the
miss (resolveAgainAfterRefreshOnMissingProgram passes it).

* Read an injected shell environment once per runtime, as main does

The previous commit read an injected environment on every acquisition, which
broke main's 'caches shell exports but re-reads configured overrides for a
resume' contract. It is read once when the resolvers are made again.

* Model lists reread the environment on a missing program, as launches do

Live QA: the first new chat after installing Claude showed "Claude wasn't
found on the computer running this chat". The chat launch itself reread the
login shell and started the new binary, but Claude's model-list check ran
first, with the environment read before the install, and never retried:
catalog probes were deliberately built without the miss refresh.

The retry now lives in each agent's one shared lookup of its binary and
environment, which a launch and a model listing both call:
resolveCodexStructuredInvocation, resolveAcpLaunchInvocation, a new shared
resolvePiRpcInvocation, and resolveClaudeChildEnvSources (which already had
it). Each catalog probe is given the runtime's refreshAfterMissingProgram,
and the catalog context no longer strips it, so a listing and a launch
reread the same single-owner environment the same way.

* Pass optional launch lookups through directly instead of conditional spreads

* Read the host shell env through resolveLoginShellEnvironment; drop the extra wait cap

CI on the merge with main failed main's new codex-workspace-relative-path
test (#26684), which mocks the login-shell module with only
resolveLoginShellEnvironment: the wrapper called captureLoginShellEnvironment
and imported the spawn-timeout constant. The wrapper only needs the env, so
it reads through resolveLoginShellEnvironment again, as on main.

The miss wait no longer races its own 5 s timer: the shell run it waits for
is already killed at the spawn timeout, so the second cap was a guard over
the same bound. The constant goes back to private, as on main.

* Test that a hung login shell holds a launch miss for at most one shell timeout

The bound lives in the one owner: the shell run is killed at the spawn
timeout (5 s) and settles to a fallback, which never replaces a captured
snapshot. A mutation raising that timeout fails this test.

* A program found through a relative PATH entry is not missing

Main's #26684 runs Codex through a workspace-relative PATH entry (`bin`,
`node_modules/.bin`). The lookup searches such an entry against Orca's own
directory and returns the bare name; the spawn then finds the program in the
chat's directory. Counting that bare name as missing made every such launch
wait for a login-shell reread.

The retry now fires only when the lookup truly found nothing: a bare name back
from a PATH whose entries are all absolute. Each agent's one lookup tells it
which PATH it searched.

* Count a relative PATH entry as found only when it holds the program; Windows miss waits for a saved PATH read started after it looked

A bare name with a relative PATH entry is checked from the launch's working
directory, so an agent in neither entry still gets its one reread. On Windows the
miss no longer joins a registry read that began before the lookup.
This was referenced Oct 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants