JoinGrove

Run Modes

Source: product.json → joingroveRunAnywhere, joingroveSelfHosted
Generated: 01/09/2026

Key Concepts

JoinGrove runs on low-spec laptops, browser-only Chromebooks, self-hosted campus VMs, and secure tunnels — not only as a local desktop IDE.

API / Reference

Mode Launch Use case
Local desktop (Agents) npm run dev Default agent-first IDE on your machine
Classic workbench ./scripts/code.sh --classic Full VS Code UI locally
Remote server (REH) npm run server Headless backend on VM or lab server
Web workbench npm run web Classic UI in browser (dev)
Agents in browser npm run sessions-web Agent-first UI in browser (:8081)
Remote tunnel joingrove tunnel Expose your machine via secure tunnel
PWA install joingrove.installPwa Install as app on Chromebook / browser
Campus Docker docker compose -f docker/campus/docker-compose.yml up -d Self-hosted campus image
Self-hosted REH joingrove.selfHostedWizard Guided setup on $5/mo VM
Low-spec build npm run build-fast Faster compile for campus labs

Web classic URL: append ?classic=true. Default editor web URL: http://127.0.0.1:9888.

Docker image: joingrove/server:latest · default port 9888.

Wizard: joingrove.runAnywhereWizard

Setup & Installation

Reference tables are generated from canonical sources (product.json, command registrations, egress policy). After changing those sources, regenerate:

node scripts/generate-docs-reference.mjs

Next: Run npm run verify-docs to confirm tables match sources.

Code Examples

npm run generate-docs-reference

Next: Open the docs hub with joingrove.openDocsHub or browse topics with joingrove.openDocsTopic.

How It Connects