JoinGrove

Install on macOS

Source: docs/get-started/install-macos.md
Generated: 01/09/2026

Run JoinGrove on macOS — from source, packaged app, or browser via REH.

Key Concepts

  • What: macOS install paths for development (npm run dev), production packages, PWA, and tunnel access.
  • Why: Mac laptops are common in bootcamps and founder cohorts — same agent-first defaults as other platforms.
  • Related: Quickstart (quickstart.md), run modes (run-modes.md).

API / Reference

Mode Command Use case
Dev (Agents) npm run dev Local development
Classic IDE ./scripts/code.sh --classic Full workbench
REH server npm run server Headless server on Mac mini / VM
Agents in browser npm run sessions-web Port 8081
Tunnel joingrove tunnel Expose local server securely
PWA joingrove.installPwa Install from browser session

Setup & Installation

  1. Install Node.js 24.13+ (nvm recommended) and Python 3.
  2. Clone repo → npm install → npm run dev.
  3. For packaged builds, follow upstream VS Code compile wiki with JoinGrove product.json.
  4. Optional — Command Palette → Choose How to Run JoinGrove… (joingrove.runAnywhereWizard).

Code Examples

Development launch:

npm install
npm run dev

Fast build for low-spec Mac:

npm run build-fast
./scripts/code.sh

Start REH server:

npm run server

Next: Open http://127.0.0.1:9888 (or your configured joingroveRunAnywhere.defaultEditorWebUrl).

How It Connects