Alex Newman
bb033b95f1
- Issue #514: Documented analysis of orphaned observer session files, including root cause, evidence, and recommended fixes. - Issue #517: Analyzed PowerShell escaping issues in cleanupOrphanedProcesses() on Windows, with recommended fixes using WMIC. - Issue #520: Confirmed resolution of stuck messages issue through architectural changes to a claim-and-delete pattern. - Issue #527: Identified detection failure of uv on Apple Silicon Macs with Homebrew installation, proposed path updates for detection. - Issue #532: Analyzed memory leak issues in SessionManager, detailing session cleanup and conversationHistory growth concerns, with recommended fixes.
3.7 KiB
Issue #527: uv Detection Fails on Apple Silicon Macs with Homebrew Installation
Date: 2026-01-04 Issue: GitHub Issue #527 Status: Confirmed - Fix Required
Summary
The isUvInstalled() function fails to detect uv when installed via Homebrew on Apple Silicon Macs because it does not check the /opt/homebrew/bin/uv path.
Analysis
Files Affected
Two copies of smart-install.js exist in the codebase:
- Source file:
/Users/alexnewman/Scripts/claude-mem/scripts/smart-install.js - Built/deployed file:
/Users/alexnewman/Scripts/claude-mem/plugin/scripts/smart-install.js
Current uv Path Detection
Source file (scripts/smart-install.js) - Lines 22-24:
const UV_COMMON_PATHS = IS_WINDOWS
? [join(homedir(), '.local', 'bin', 'uv.exe'), join(homedir(), '.cargo', 'bin', 'uv.exe')]
: [join(homedir(), '.local', 'bin', 'uv'), join(homedir(), '.cargo', 'bin', 'uv'), '/usr/local/bin/uv'];
Plugin file (plugin/scripts/smart-install.js) - Lines 103-105:
const uvPaths = IS_WINDOWS
? [join(homedir(), '.local', 'bin', 'uv.exe'), join(homedir(), '.cargo', 'bin', 'uv.exe')]
: [join(homedir(), '.local', 'bin', 'uv'), join(homedir(), '.cargo', 'bin', 'uv'), '/usr/local/bin/uv'];
Paths Currently Checked (Unix/macOS)
| Path | Installer | Architecture |
|---|---|---|
~/.local/bin/uv |
Official installer | Any |
~/.cargo/bin/uv |
Cargo/Rust install | Any |
/usr/local/bin/uv |
Homebrew (Intel) | x86_64 |
Missing Path
| Path | Installer | Architecture |
|---|---|---|
/opt/homebrew/bin/uv |
Homebrew (Apple Silicon) | arm64 |
Root Cause
Homebrew installs to different prefixes depending on architecture:
- Intel Macs (x86_64):
/usr/local/bin/ - Apple Silicon Macs (arm64):
/opt/homebrew/bin/
The current implementation only includes the Intel Homebrew path, causing detection to fail on Apple Silicon when:
- uv is installed via
brew install uv - The user's shell PATH is not available during script execution (common in non-interactive contexts)
Impact
Users on Apple Silicon Macs who installed uv via Homebrew will:
- See "uv not found" errors
- Have uv unnecessarily reinstalled via the official installer
- End up with duplicate installations
Recommended Fix
Add /opt/homebrew/bin/uv to the Unix paths array.
Source file (scripts/smart-install.js) - Line 24
Before:
: [join(homedir(), '.local', 'bin', 'uv'), join(homedir(), '.cargo', 'bin', 'uv'), '/usr/local/bin/uv'];
After:
: [join(homedir(), '.local', 'bin', 'uv'), join(homedir(), '.cargo', 'bin', 'uv'), '/usr/local/bin/uv', '/opt/homebrew/bin/uv'];
Plugin file (plugin/scripts/smart-install.js) - Lines 103-105 and 222-224
The same fix should be applied in both locations where uvPaths is defined:
- Line 105 in
isUvInstalled() - Line 224 in
installUv()
Note: Bun Has the Same Issue
The Bun detection has the same gap:
Current (scripts/smart-install.js line 20):
: [join(homedir(), '.bun', 'bin', 'bun'), '/usr/local/bin/bun'];
Should also add:
: [join(homedir(), '.bun', 'bin', 'bun'), '/usr/local/bin/bun', '/opt/homebrew/bin/bun'];
Verification
After the fix, verify by:
- Installing uv via Homebrew on an Apple Silicon Mac
- Running the smart-install script
- Confirming uv is detected without attempting reinstallation
Conclusion
Fix is required. The /opt/homebrew/bin/uv path is missing from both files. This is a simple one-line addition to the path arrays. The same fix should also be applied to Bun detection paths for consistency.