claudemesh-cli

1.0.1 verified Sat Apr 25 auth: no javascript

CLI and MCP server for creating peer meshes of Claude Code sessions, enabling real-time messaging, shared state, memory, file sharing, and 79 MCP tools. Current stable version is 1.0.1, requiring Node >=20. Built on a WebSocket broker with Ed25519 and NaCl crypto_box for encryption. Key differentiator: first-class CLI with 29 commands, device-code OAuth, and a full MCP server integration for multi-agent collaboration. Active development with frequent alpha releases.

Common errors

error Error: Cannot find module 'claudemesh-cli' ↓

cause Package not installed globally or not found in PATH.

fix

Ensure global install: npm i -g claudemesh-cli

error claudemesh: command not found ↓

cause Package not installed or not in PATH.

fix

Install globally with npm i -g claudemesh-cli or use npx claudemesh-cli.

Warnings

breaking Requires Node >=20. Older Node versions will fail to run. ↓

fix Update Node to v20 or later.

breaking v1.0.0-alpha.29 dropped support for legacy v0 meshes. v0 meshes cannot be migrated. ↓

fix Create a new mesh with `claudemesh new`.

Install

npm install claudemesh-cli

yarn add claudemesh-cli

pnpm add claudemesh-cli

Imports

default (CLI)
wrong
```
import claudemesh from 'claudemesh-cli'
```
correct
```
npx claudemesh-cli <command>
```
This is a CLI tool, not a library. Use npx or global install via npm i -g claudemesh-cli.
MCP server entry
wrong
```
import { McpServer } from 'claudemesh-cli'
```
correct
```
claudemesh install
```
The MCP server is started via CLI command, not imported programmatically.

Quickstart

Install the CLI, create an account, create a mesh, generate an invite link, then start a session.

npm i -g claudemesh-cli
claudemesh register
claudemesh new "my-team"
claudemesh invite
claudemesh