Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

docs: state the macOS 12 (Monterey) floor for the app and for building it

review1d63eddce444
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 103890f03..02919bf2a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -12,6 +12,10 @@ ordinary work.
## Getting set up
+You need Node.js 20+ (22 for the Server Edition) on Linux or **macOS 12 Monterey or newer** —
+the macOS floor is Electron's and esbuild's, and the README's *Build from source* section says
+what fails on an older Mac.
+
```bash
npm install # also patches + rebuilds node-pty against Electron's ABI (postinstall)
npm run dev # dev mode with renderer HMR
diff --git a/README.md b/README.md
index 8e1b114b3..b5bf285fa 100644
--- a/README.md
+++ b/README.md
@@ -198,7 +198,8 @@ Grab the latest build from **[nodeterm.dev](https://nodeterm.dev)** — the down
detects your platform. Everything is also listed at
[nodeterm.dev/releases](https://nodeterm.dev/releases):
-- **macOS** — `.dmg` for Apple Silicon and Intel (auto-updates), or **Homebrew**:
+- **macOS 12 Monterey or newer** — `.dmg` for Apple Silicon and Intel (auto-updates), or
+ **Homebrew**:
```bash
brew install --cask nodeterm
@@ -278,8 +279,8 @@ [email protected] — and a ⭐ helps too.
## 🛠 Build from source
-Requires Node.js 20+ on macOS or Linux (tmux recommended — it's what makes sessions
-survive restarts). A source checkout does **not** carry the bundled tmux: run
+Requires Node.js 20+ on **macOS 12 Monterey or newer** or Linux (tmux recommended — it's
+what makes sessions survive restarts). A source checkout does **not** carry the bundled tmux: run
`node scripts/build-tmux.mjs` once on macOS to build it into `resources/bin/tmux` (the
release job does this automatically), or just install tmux yourself. On **Windows**, run
`bootstrap-windows.bat` from a fresh checkout first — it checks for Node, the Visual Studio
@@ -311,6 +312,14 @@ npm run dist:win # unsigned NSIS installer + zip into dist/ (on a Windows host
npm run server:dev # build + run the browser Server Edition (needs Node 22 + tmux)
```
+**Minimum macOS is 12 (Monterey), for the app and for building it.** Both floors belong to
+the toolchain, not to nodeterm: Electron 42 ships binaries for Monterey and up, so the `.dmg`
+does not launch on Big Sur, and the `esbuild` binary that Vite and the Server Edition build
+use is compiled with Go 1.25, which dropped macOS 11 — on Big Sur `npm install` dies in
+esbuild's postinstall with `dyld: Symbol not found: _SecTrustCopyCertificateChain`, and
+nothing downstream (`electron-vite`, `server:dev`) exists. An older Mac can still use nodeterm
+by running the [Server Edition](./docs/SERVER.md) on a Linux host and opening it in a browser.
+
## ⌨️ Keyboard shortcuts
These are the defaults — every one of them is remappable in **Settings → Keyboard Shortcuts**.
diff --git a/docs/SERVER.md b/docs/SERVER.md
index ac53842c3..a928644f4 100644
--- a/docs/SERVER.md
+++ b/docs/SERVER.md
@@ -12,6 +12,11 @@ unchanged. It boots the same Electron-free core services (`src/core/`) through a
## Quickstart
+Host requirements: Linux, or macOS 12 Monterey or newer. Building the server runs the same
+`esbuild` binary Vite uses, and that binary needs macOS 12+ (see **Build from source** in the
+README) — a Big Sur Mac cannot build or run the Server Edition, but any browser on it can open
+one hosted elsewhere.
+
```bash
npm run server:dev
```