diff --git a/packages/core/src/tools/ripGrep.ts b/packages/core/src/tools/ripGrep.ts index 000b4f0071..18a1b0c133 100644 --- a/packages/core/src/tools/ripGrep.ts +++ b/packages/core/src/tools/ripGrep.ts @@ -54,7 +54,23 @@ async function resolveExistingRgPath(): Promise { } let ripgrepAcquisitionPromise: Promise | null = null; - +/** + * Ensures a ripgrep binary is available. + * + * NOTE: + * - The Gemini CLI currently prefers a managed ripgrep binary downloaded + * into its global bin directory. + * - Even if ripgrep is available on the system PATH, it is intentionally + * not used at this time. + * + * Preference for system-installed ripgrep is blocked on: + * - checksum verification of external binaries + * - internalization of the get-ripgrep dependency + * + * See: + * - feat(core): Prefer rg in system path (#11847) + * - Move get-ripgrep to third_party (#12099) + */ async function ensureRipgrepAvailable(): Promise { const existingPath = await resolveExistingRgPath(); if (existingPath) {