Function startDeferredPrefetches

src/main.tsx:439–493

()

 * Call this after the REPL has been rendered.
 */
export function startDeferredPrefetches(): void {
  // This function runs after first render, so it doesn't block the initial paint.
  // However, the spawned processes and async work still contend for CPU and event
  // loop time, which skews startup benchmarks (CPU profiles, time-to-first-render
  // measurements). Skip all of it when we're only measuring startup performance.
  if (isEnvTruthy(process.env.CLAUDE_CODE_EXIT_AFTER_FIRST_RENDER) ||
  // --bare: skip ALL prefetches. These are cache-warms for the REPL's
  // first-turn responsiveness (initUser, getUserContext, tips, countFiles,
  // modelCapabilities, change detectors). Scripted -p calls don't have a
  // "user is typing" window to hide this work in — it's pure overhead on
  // the critical path.
  isBareMode()) {
    return;
  }

  if (isDeferredHeadlessPluginStartupSurfacesEnabled()) {
    logForDebugging('[STARTUP] Skipping deferred prefetches during deferred headless startup');
    return;
  }

  // Process-spawning prefetches (consumed at first API call, user is still typing)
  void initUser();
  void getUserContext();
  prefetchSystemContextIfSafe();
  void getRelevantTips();
  if (shouldPrefetchAwsCredentialsAtStartup({
    useBedrock: isEnvTruthy(process.env.CLAUDE_CODE_USE_BEDROCK),
    skipBedrockAuth: isEnvTruthy(process.env.CLAUDE_CODE_SKIP_BEDROCK_AUTH),
  })) {
    void prefetchCurrentAwsCredentialsAndBedrockInfoIfSafe();
  }
  if (shouldPrefetchGcpCredentialsAtStartup({
    useVertex: isEnvTruthy(process.env.CLAUDE_CODE_USE_VERTEX),
    skipVertexAuth: isEnvTruthy(process.env.CLAUDE_CODE_SKIP_VERTEX_AUTH),
  })) {
    void prefetchCurrentGcpCredentialsIfSafe();
  }
  void countFilesRoundedRg(getCwd(), AbortSignal.timeout(3000), []);

  // Analytics and feature flag initialization
  void initializeAnalyticsGates();
  void prefetchOfficialMcpUrls();
  void refreshModelCapabilities();

  // File change detectors deferred from init() to unblock first render
  void settingsChangeDetector.initialize();
  if (!isBareMode()) {
    void skillChangeDetector.initialize();
  }

  // Event loop stall detector — logs when the main thread is blocked >500ms
  if (isInternalBuild()) {
    void import('./utils/eventLoopStallDetector.js').then(m => m.startEventLoopStallDetector());
  }
}
function loadSettingsFromFlag(settingsFile: string): void {
  try {
    const trimmedSettings = settingsFile.trim();