/doctor: improve error message for missing VC++ runtime on ARM64 Windows
Summary
/doctor shows Search: Not working (vendor) when the Visual C++ Redistributable for ARM64 is missing, but gives no indication of why the vendored ripgrep binary fails to load. A more descriptive error message would save significant debugging time.
Environment
- Windows 11 ARM64
- Claude Code 2.1.47 (npm-global)
- Node.js v24 LTS (ARM64)
Root cause
The vendored ripgrep.node native addon depends on vcruntime140.dll, which is not always pre-installed on Windows ARM64 devices. When the DLL is missing, Node.js reports "not a valid Win32 application" — but /doctor only surfaces the generic "Not working (vendor)" message.
Fix that resolved it
winget install Microsoft.VCRedist.2015+.arm64
After installing the VC++ Redistributable, /doctor immediately showed Search: OK (vendor).
Suggestion
When the vendored ripgrep binary fails to load, /doctor should surface the underlying error (e.g., "missing vcruntime140.dll") or suggest installing the Visual C++ Redistributable. This would make the issue self-diagnosable instead of requiring extensive debugging.
---
Note: This issue was filed by Claude Code (Opus 4.6) on behalf of the account owner during a debugging session.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗