You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[Bug]: loopx app runing failed on macbook M5 #9133
Characterized on current main; this is the documented system-prerequisite path, not an M5-specific defect. 2.3.0 is the current stable, so there is also no newer release that changes this behavior.
What the message means
The App installs its bundled runtime snapshot by running scripts/install-local.sh (spawned from apps/desktop/loopx-control-plane/src-tauri/src/bundled_runtime.rs). The installer validates the release candidate with loopx --format json doctor --deep --installation-only; the typescript_effect_runtime_ready doctor check is required and fails closed when no Node.js is found on the probe PATH (loopx/control_plane/runtime/node_probe.py resolves node via shutil.which). Doctor then exits 1, the installer exits 1, and the App surfaces runtime_install_exit_1. The boot page combines that exit code with the environment probe environment.node_found=false and renders the message in your screenshot (「安装程序退出(1);App 的启动环境未找到 Node.js…」).
Why Node is expected
LoopX's control plane runs a managed TypeScript Effect runtime that requires Node.js 22.22.3 or newer (Node.js 24 LTS recommended) on the machine; the App bundles its own source snapshot and verified frontend but deliberately does not bundle Node (see docs/guides/installing-loopx.md, "Validate Node before installing or upgrading LoopX"). A fresh Mac has no Node, so first boot stops here — the same shape as the documented fresh-Mac-without-Python case (runtime_install_exit_2) in the App README's Known Issues.
One nuance worth knowing: a Finder-launched App does not inherit your shell PATH. The App searches a bounded set (~/.local/bin, /opt/homebrew/bin, /usr/local/bin, the Homebrew keg-only node@24/node@22 prefixes, then the inherited process PATH). Node installed via nvm/fnm/volta is invisible to the App even though it works in your terminal.
Self-service recovery
Install a supported Node: brew install node (or brew install node@24), or the official installer from nodejs.org (22.22.3+).
Reopen the App, or press 「修复当前版本」(Repair this version) in the 恢复与更新 (Recovery & updates) panel; the environment probe refreshes automatically and installation resumes.
Verify via the App's own 诊断信息 (Diagnostics) panel — environment.node_found / node_version — rather than only a terminal, since that also answers the nvm case above.
If it still fails with a Node the App can see, expand 诊断信息 on the boot screen, press the copy button, and attach it here; the diagnostics block in the report is empty, and that JSON (public-safe by design) is what we would need next.
Follow-up
The App README (apps/desktop/loopx-control-plane/README.md) documents the Python analog of this failure but not the Node one. I'll send a small docs PR adding the parallel Known Issues entry so this recovery path is documented alongside the Python case.
Docs sent in #9135 (branch codex/app-nodejs-missing-9133, based on latest maineb552a8bb): the App README's Known Issues now documents this exact failure (runtime_install_exit_1 + environment.node_found=false) with the self-service steps above, mirroring the existing fresh-Mac-without-Python entry, and the Prerequisites Node bullet now states the actual 22.22.3+ (24 LTS recommended) runtime requirement. Docs-only; no code or packaging change, since the runtime requiring a user-provided Node is the documented design. If installing a visible Node does not unblock your App, please attach the copied diagnostics JSON from the boot screen.
Thanks — that confirms the exact variant characterized above: your Node lives under ~/.nvm/versions/node/v24.22.1/bin, and the Finder-launched App does not load your shell profile, so its bounded node search (~/.local/bin, /opt/homebrew/bin, /usr/local/bin, Homebrew keg-only node@24/node@22 prefixes, then the inherited process PATH) never sees nvm-managed binaries. The App's diagnostics would show node_found=false for the same reason.
Quickest fixes (any one):
brew install node@24 (or node@22) — the App resolves the Homebrew prefix directly; or
Symlink the existing binary into a searched location, e.g. mkdir -p ~/.local/bin && ln -s ~/.nvm/versions/node/v24.22.1/bin/node ~/.local/bin/node; or
Launch the App from a terminal (open -a LoopX...) after nvm use 24 so it inherits your shell PATH.
Then use Repair this version (or restart the App) so the runtime installation re-runs; the boot screen should clear once node --version resolves to 24.22.1. The README patch in #9135 adds this exact recovery entry to Known Issues.
Activity
LIHUA919 commentedon Nov 20, 2026
Characterized on current
main; this is the documented system-prerequisite path, not an M5-specific defect. 2.3.0 is the current stable, so there is also no newer release that changes this behavior.What the message means
The App installs its bundled runtime snapshot by running
scripts/install-local.sh(spawned fromapps/desktop/loopx-control-plane/src-tauri/src/bundled_runtime.rs). The installer validates the release candidate withloopx --format json doctor --deep --installation-only; thetypescript_effect_runtime_readydoctor check is required and fails closed when no Node.js is found on the probe PATH (loopx/control_plane/runtime/node_probe.pyresolvesnodeviashutil.which). Doctor then exits 1, the installer exits 1, and the App surfacesruntime_install_exit_1. The boot page combines that exit code with the environment probeenvironment.node_found=falseand renders the message in your screenshot (「安装程序退出(1);App 的启动环境未找到 Node.js…」).Why Node is expected
LoopX's control plane runs a managed TypeScript Effect runtime that requires Node.js 22.22.3 or newer (Node.js 24 LTS recommended) on the machine; the App bundles its own source snapshot and verified frontend but deliberately does not bundle Node (see
docs/guides/installing-loopx.md, "Validate Node before installing or upgrading LoopX"). A fresh Mac has no Node, so first boot stops here — the same shape as the documented fresh-Mac-without-Python case (runtime_install_exit_2) in the App README's Known Issues.One nuance worth knowing: a Finder-launched App does not inherit your shell PATH. The App searches a bounded set (
~/.local/bin,/opt/homebrew/bin,/usr/local/bin, the Homebrew keg-onlynode@24/node@22prefixes, then the inherited process PATH). Node installed via nvm/fnm/volta is invisible to the App even though it works in your terminal.Self-service recovery
brew install node(orbrew install node@24), or the official installer from nodejs.org (22.22.3+).environment.node_found/node_version— rather than only a terminal, since that also answers the nvm case above.If it still fails with a Node the App can see, expand 诊断信息 on the boot screen, press the copy button, and attach it here; the diagnostics block in the report is empty, and that JSON (public-safe by design) is what we would need next.
Follow-up
The App README (
apps/desktop/loopx-control-plane/README.md) documents the Python analog of this failure but not the Node one. I'll send a small docs PR adding the parallel Known Issues entry so this recovery path is documented alongside the Python case.LIHUA919 commentedon Nov 20, 2026
Docs sent in #9135 (branch
codex/app-nodejs-missing-9133, based on latestmaineb552a8bb): the App README's Known Issues now documents this exact failure (runtime_install_exit_1+environment.node_found=false) with the self-service steps above, mirroring the existing fresh-Mac-without-Python entry, and the Prerequisites Node bullet now states the actual 22.22.3+ (24 LTS recommended) runtime requirement. Docs-only; no code or packaging change, since the runtime requiring a user-provided Node is the documented design. If installing a visible Node does not unblock your App, please attach the copied diagnostics JSON from the boot screen.xiaods commentedon Nov 21, 2026
my node is here:
❯ which node
/Users/xiaodeshi/.nvm/versions/node/v24.22.1/bin/node
LIHUA919 commentedon Nov 21, 2026
Thanks — that confirms the exact variant characterized above: your Node lives under
~/.nvm/versions/node/v24.22.1/bin, and the Finder-launched App does not load your shell profile, so its boundednodesearch (~/.local/bin,/opt/homebrew/bin,/usr/local/bin, Homebrew keg-onlynode@24/node@22prefixes, then the inherited process PATH) never sees nvm-managed binaries. The App's diagnostics would shownode_found=falsefor the same reason.Quickest fixes (any one):
brew install node@24(ornode@22) — the App resolves the Homebrew prefix directly; ormkdir -p ~/.local/bin && ln -s ~/.nvm/versions/node/v24.22.1/bin/node ~/.local/bin/node; oropen -a LoopX...) afternvm use 24so it inherits your shell PATH.Then use Repair this version (or restart the App) so the runtime installation re-runs; the boot screen should clear once
node --versionresolves to 24.22.1. The README patch in #9135 adds this exact recovery entry to Known Issues.