gemini-cli - 💡(How to fix) Fix bug: Gemini CLI crashes on Alpine Linux (musl libc) due to PTY resize error and relaunch IPC failure [1 pull requests]

Bug Report

Environment:

• OS: Alpine Linux 3.21 (musl libc)
• Node.js: v24.x
• Gemini CLI: v0.42.0-nightly.20260507.ga809bc7c5

Describe the bug

Gemini CLI crashes on Alpine Linux when attempting to execute shell tools/commands. Two root causes were identified in packages/cli/index.ts:

1. PTY resize uncaught exception not suppressed on non-Windows platforms

The uncaughtException handler that suppresses PTY resize race-condition errors only activates on win32:

if (process.platform === 'win32' && err.code === 'EIO' ...) { return; }

On Alpine Linux, the same PTY resize race can throw an unhandled exception when a PTY session (such as the one used for executing shell commands) exits, crashing the main process.

2. Child-process relaunch via IPC fails on Alpine/musl

The CLI relaunch mechanism spawns a child with {ipc: true}. On Alpine Linux with musl libc, this IPC channel fails silently, causing issues with process lifecycle management.

Steps to reproduce

1. Start Alpine environment: docker run --rm -it node:alpine /bin/sh
2. Install CLI: npm install -g @google/gemini-cli@nightly
3. Login to account
4. Run gemini and prompt: "check my kernel version"
5. The CLI attempts to run uname -a and crashes immediately.

Expected behavior

CLI runs normally on Alpine Linux and can successfully execute shell commands without crashing.

Proposed fix

PR #26689 fixes both issues in packages/cli/index.ts:

1. Detect Alpine at startup (check for /etc/alpine-release) and set GEMINI_CLI_NO_RELAUNCH=true
2. Remove the process.platform === 'win32' guard on PTY resize error suppression so it applies on all platforms