ruvnet / ruvnet/ruflo

Installation of claude-flow@alpha fails on macOS with Node.js v24.3.0

Open
#556 3 comments 1 reaction 0 assignees View on GitHub
already-fixed
Dominant language
TypeScript
Stars
72.7k
Forks
8.6k
Avg merge
2d 23h
Merged PRs (30d)
83

Description

## Description

Installation of `claude-flow@alpha` fails on macOS (Darwin 24.6.0) with Node.js v24.3.0 due to native module compilation issues with `better-sqlite3`.

## Environment

- **OS**: macOS Darwin 24.6.0
- **Node**: v24.3.0
- **npm**: (included with Node)
- **Architecture**: arm64 (Apple Silicon)
- **Python**: 3.13.5

## Steps to Reproduce

```bash
npm install -g claude-flow@alpha
Full Error Log

Click to expand error log
npm error code 1
npm error path /opt/homebrew/lib/node_modules/claude-flow/node_modules/ruv-swarm/node_modules/better-sqlite3
npm error command failed
npm error command sh -c prebuild-install || node-gyp rebuild --release
npm error (node:90243) [DEP0176] DeprecationWarning: fs.R_OK is deprecated, use fs.constants.R_OK instead
npm error (Use `node --trace-deprecation ...` to show where the warning was created)
npm error prebuild-install warn install No prebuilt binaries found (target=24.3.0 runtime=node arch=arm64 libc= platform=darwin)
npm error gyp info it worked if it ends with ok
npm error gyp info using node-gyp@11.2.0
npm error gyp info using node@24.3.0 | darwin | arm64
npm error gyp info find Python using Python version 3.13.5 found at "/opt/homebrew/opt/python@3.13/bin/python3.13"
npm error gyp info spawn /opt/homebrew/opt/python@3.13/bin/python3.13
npm error gyp info spawn args [
npm error gyp info spawn args '/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py',
npm error gyp info spawn args 'binding.gyp',
npm error gyp info spawn args '-f',
npm error gyp info spawn args 'make',
npm error gyp info spawn args '-I',
npm error gyp info spawn args '/opt/homebrew/lib/node_modules/claude-flow/node_modules/ruv-swarm/node_modules/better-sqlite3/build/config.gypi',
npm error gyp info spawn args '-I',
npm error gyp info spawn args '/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/addon.gypi',
npm error gyp info spawn args '-I',
npm error gyp info spawn args '/Users/[USERNAME]/Library/Caches/node-gyp/24.3.0/include/node/common.gypi',
npm error gyp info spawn args '-Dlibrary=shared_library',
npm error gyp info spawn args '-Dvisibility=default',
npm error gyp info spawn args '-Dnode_root_dir=/Users/[USERNAME]/Library/Caches/node-gyp/24.3.0',
npm error gyp info spawn args '-Dnode_gyp_dir=/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp',
npm error gyp info spawn args '-Dnode_lib_file=/Users/[USERNAME]/Library/Caches/node-gyp/24.3.0/<(target_arch)/node.lib',
npm error gyp info spawn args '-Dmodule_root_dir=/opt/homebrew/lib/node_modules/claude-flow/node_modules/ruv-swarm/node_modules/better-sqlite3',
npm error gyp info spawn args '-Dnode_engine=v8',
npm error gyp info spawn args '--depth=.',
npm error gyp info spawn args '--no-parallel',
npm error gyp info spawn args '--generator-output',
npm error gyp info spawn args 'build',
npm error gyp info spawn args '-Goutput_dir=.'
npm error gyp info spawn args ]
npm error No receipt for 'com.apple.pkg.CLTools_Executables' found at '/'.
npm error
npm error No receipt for 'com.apple.pkg.DeveloperToolsCLILeo' found at '/'.
npm error
npm error No receipt for 'com.apple.pkg.DeveloperToolsCLI' found at '/'.
npm error
npm error Traceback (most recent call last):
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py", line 1502, in XcodeVersion
npm error version_list = GetStdoutQuiet(["xcodebuild", "-version"]).splitlines()
npm error ~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py", line 1563, in GetStdoutQuiet
npm error raise GypError("Error %d running %s" % (job.returncode, cmdlist[0]))
npm error gyp.common.GypError: Error 1 running xcodebuild
npm error
npm error During handling of the above exception, another exception occurred:
npm error
npm error Traceback (most recent call last):
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py", line 45, in
npm error sys.exit(gyp.script_main())
npm error ~~~~~~~~~~~~~~~^^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__init__.py", line 700, in script_main
npm error return main(sys.argv[1:])
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__init__.py", line 692, in main
npm error return gyp_main(args)
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/__init__.py", line 677, in gyp_main
npm error generator.GenerateOutput(flat_list, targets, data, params)
npm error ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/make.py", line 2682, in GenerateOutput
npm error writer.Write(
npm error ~~~~~~~~~~~~^
npm error qualified_target,
npm error ^^^^^^^^^^^^^^^^^
npm error ...<4 lines>...
npm error part_of_all=qualified_target in needed_targets,
npm error ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
npm error )
npm error ^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/make.py", line 893, in Write
npm error self.WriteActions(
npm error ~~~~~~~~~~~~~~~~~^
npm error spec["actions"],
npm error ^^^^^^^^^^^^^^^^
npm error ...<3 lines>...
npm error part_of_all,
npm error ^^^^^^^^^^^^
npm error )
npm error ^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/make.py", line 1027, in WriteActions
npm error env = self.GetSortedXcodeEnv()
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/generator/make.py", line 2279, in GetSortedXcodeEnv
npm error return gyp.xcode_emulation.GetSortedXcodeEnv(
npm error ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
npm error self.xcode_settings,
npm error ^^^^^^^^^^^^^^^^^^^^
npm error ...<3 lines>...
npm error additional_settings,
npm error ^^^^^^^^^^^^^^^^^^^^
npm error )
npm error ^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py", line 1888, in GetSortedXcodeEnv
npm error env = _GetXcodeEnv(
npm error xcode_settings, built_products_dir, srcroot, configuration, additional_settings
npm error )
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py", line 1743, in _GetXcodeEnv
npm error "XCODE_VERSION_ACTUAL": XcodeVersion()[0],
npm error ~~~~~~~~~~~~^^
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py", line 1513, in XcodeVersion
npm error version = CLTVersion() # macOS Catalina returns 11.0.0.0.1.1567737322
npm error File "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/gyp/pylib/gyp/xcode_emulation.py", line 1551, in CLTVersion
npm error return re.search(regex, output).groupdict()["version"]
npm error ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
npm error AttributeError: 'NoneType' object has no attribute 'groupdict'
npm error gyp ERR! configure error
npm error gyp ERR! stack Error: `gyp` failed with exit code: 1
npm error gyp ERR! stack at ChildProcess. (/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/lib/configure.js:317:18)
npm error gyp ERR! stack at ChildProcess.emit (node:events:507:28)
npm error gyp ERR! stack at ChildProcess._handle.onexit (node:internal/child_process:294:12)
npm error gyp ERR! System Darwin 24.6.0
npm error gyp ERR! command "/opt/homebrew/Cellar/node/24.3.0/bin/node" "/opt/homebrew/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild" "--release"
npm error gyp ERR! cwd /opt/homebrew/lib/node_modules/claude-flow/node_modules/ruv-swarm/node_modules/better-sqlite3
npm error gyp ERR! node -v v24.3.0
npm error gyp ERR! node-gyp -v v11.2.0
npm error gyp ERR! not ok
npm error A complete log of this run can be found in: /Users/[USERNAME]/.npm/_logs/2025-07-31T19_45_36_740Z-debug-0.log

```

Expected Behavior
The package should install successfully or provide prebuilt binaries for Node v24.3.0 on macOS arm64.
Possible Solutions

Provide prebuilt binaries for Node v24.3.0 on macOS arm64
Update better-sqlite3 dependency to a version that supports Node v24
Document any specific requirements for compilation on macOS
Fix the issue with xcodebuild detection on recent macOS versions

Additional Context
The error appears to be related to:

Missing prebuilt binaries for the specific Node.js version (v24.3.0)
Issues with Xcode command line tools detection
Compatibility problems between better-sqlite3 and Node.js v24

The core error is: AttributeError: 'NoneType' object has no attribute 'groupdict' when trying to detect the Xcode version during the build process.

Contributor guide

Open the contributing guide

Research direction

Start with the claude-flow@alpha dependency tree and the better-sqlite3 package under ruv-swarm, then reproduce the npm install on macOS arm64 with Node.js v24.3.0. Check the prebuild-install and node-gyp failure details, including Xcode command-line-tools detection; done means the package installs successfully or its macOS compilation requirements are documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos, node.js, sqlite
Domain
build-system
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.