open-walnut 0.4.0 → 0.4.1

package/README.md

@@ -41,7 +41,9 @@ local-first, self-hosted, and has no telemetry.
 
 ### Requirements
 
-- Node.js 22 or newer
+- Node.js 22 or newer. If you don't have it: `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash` then `nvm install 22`.
+- git, only for the checkout route below (macOS: `xcode-select --install`, Ubuntu: `sudo apt install git`)
+- Linux: a C library from 2019 or later (glibc 2.29+: Ubuntu 20.04+, Debian 11+, AL2023, Fedora). Older distros compile one native module and need a newer Python and GCC first; `npm start` prints the exact commands, and [Getting Started](GETTING_STARTED.md#older-linux-glibc-before-229) has them too.
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) for coding sessions
 - An Anthropic API key, AWS Bedrock credentials, or another supported model provider
   for Walnut
@@ -51,6 +53,16 @@ Claude Code CLI login, while Walnut uses the model provider selected during setu
 
 ### Install
 
+The published package is the quickest way in. Nothing to build, and it starts in a few
+seconds:
+
+```bash
+npm install -g open-walnut
+open-walnut web
+```
+
+To work on Walnut itself, run it from a checkout instead:
+
 ```bash
 git clone https://github.com/EvanZhang008/open-walnut.git
 cd open-walnut

package/bin/open-walnut.js

@@ -15,6 +15,20 @@ import fs from 'node:fs';
 // a broken pipe means the reader got a TRUNCATED answer, and reporting that as
 // success is how a half-written JSON reply passes for a complete one. 141 is the
 // shell's SIGPIPE convention.
+// Node version: npm only WARNS about an unmet `engines`, so an old Node installs the
+// package happily and then dies inside the bundle with a syntax error that says nothing
+// about versions. Answer the real question here, once, with the command that fixes it.
+const nodeMajor = Number(process.versions.node.split('.')[0]);
+if (Number.isFinite(nodeMajor) && nodeMajor < 22) {
+  process.stderr.write(
+    `Walnut needs Node.js 22 or newer, and this is Node ${process.versions.node}.\n\n` +
+    `  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash\n` +
+    `  nvm install 22\n\n` +
+    `Then run the same command again.\n`,
+    () => process.exit(1),
+  );
+}
+
 let wroteStdout = false;
 process.stdout.on('error', (e) => {
   if (e && e.code === 'EPIPE') process.exit(wroteStdout ? 141 : 0);