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.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
docs: state the macOS 12 (Monterey) floor for the app and for building it
review1d63eddce444
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 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.+```bashnpm install # also patches + rebuilds node-pty against Electron's ABI (postinstall)npm run dev # dev mode with renderer HMRdiff --git a/README.md b/README.mdindex 8e1b114b3..b5bf285fa 100644--- a/README.md+++ b/README.md@@ -198,7 +198,8 @@ Grab the latest build from **[nodeterm.dev](https://nodeterm.dev)** — the downdetects 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**:```bashbrew 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` (therelease 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 hostnpm 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 shortcutsThese are the defaults — every one of them is remappable in **Settings → Keyboard Shortcuts**.diff --git a/docs/SERVER.md b/docs/SERVER.mdindex 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.+```bashnpm run server:dev```