Function getShellConfiguration

packages/core/src/utils/shell-utils.ts:658–699

()

 * @returns The ShellConfiguration for the current environment.
 */
export function getShellConfiguration(): ShellConfiguration {
  if (isWindows()) {
    // -NonInteractive prevents PSReadLine from intercepting console input
    // events inside the ConPTY session, which otherwise causes interactive
    // TUI tools (e.g. pnpm create vite, vim) to receive malformed key events
    // and exit when arrow keys are pressed.
    const powershellArgsPrefix = ['-NoProfile', '-NonInteractive', '-Command'];
    const comSpec = process.env['ComSpec'];
    if (comSpec) {
      const executable = comSpec.toLowerCase();
      if (
        executable.endsWith('powershell.exe') ||
        executable.endsWith('pwsh.exe')
      ) {
        return {
          executable: comSpec,
          argsPrefix: powershellArgsPrefix,
          shell: 'powershell',
        };
      }
    }

    const pwshPath = resolveExecutable('pwsh.exe');
    if (pwshPath) {
      return {
        executable: pwshPath,
        argsPrefix: ['-NoProfile', '-Command'],
        shell: 'powershell',
      };
    }

    // Fall back to Windows PowerShell 5.1 when pwsh.exe is not installed.
    return {
      executable: 'powershell.exe',
      argsPrefix: powershellArgsPrefix,
      shell: 'powershell',
    };
  }

  // Unix-like systems (Linux, macOS)
  return { executable: 'bash', argsPrefix: ['-c'], shell: 'bash' };
}

/**
 * Export the platform detection constant for use in process management (e.g., killing processes).