Quick Start Guide
LMESH enables developers to share their local terminal session with collaborators directly through any modern web browser. Follow this guide to install the CLI, authenticate with GitHub, and launch your first live session.
Prerequisites
Before getting started, make sure your local workstation meets the following runtime requirements:
Node.js 20.x or newer installed on macOS, Linux, or Windows (PowerShell / Windows Terminal with ConPTY).
Zero installations required. Collaborators join via any modern browser (Chrome, Firefox, Safari, Edge).
Installation
Install the CLI globally from the npm registry using your package manager of choice, or run directly via npx:
lmesh-clinpm install -g lmesh-cliInstalling lmesh-cli exposes both lmesh and lmesh-cli binary commands globally in your PATH. Verify installation with lmesh --version.
Authentication
LMESH uses the GitHub OAuth Device Flow for easier passwordless CLI authorization. You don't need to manually create or copy personal access tokens.
lmesh login- The CLI generates a unique 8-character verification code (e.g.
XXXX-YYYY). - Your browser automatically opens GitHub's device activation page.
- Enter the one-time code and click Authorize.
- The CLI automatically detects approval and writes your session token to
~/.lmesh/auth.json.
Starting Your First Session
Once authenticated, share your active shell session with a single command:
lmesh sharePressing Ctrl+S anytime during your session toggles Private Mode. When enabled, sensitive commands and credentials such as database passwords, API tokens, and JWTs are dynamically redacted from the web audit log and collaborator streams.