59e999535d
Pairs with claudemesh-2's new /join/[token] landing page. Users can now paste a clickable HTTPS URL instead of the dev-only ic:// scheme. apps/cli/src/invite/parse.ts — new extractInviteToken() handles four input formats before handing the raw base64url token to the existing parseInviteLink pipeline: - https://claudemesh.com/join/<token> (primary, clickable) - https://claudemesh.com/<locale>/join/<token> (i18n prefix) - ic://join/<token> (still supported, dev) - <raw-token> (last resort: bare base64url) User-facing strings updated to the HTTPS form: - cli help: "join <url>" - install success message - list (no-meshes) hint - MCP server "no meshes" error - README.md primary example - docs/QUICKSTART.md Path A + Path B Verified extractInviteToken() on all 4 formats — each returns the same base64url token → same broker /join lookup. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# claudemesh-cli
|
|
|
|
Client tool for claudemesh — install once per machine, join one or more
|
|
meshes, and your Claude Code sessions can talk to peers on demand.
|
|
|
|
## Install
|
|
|
|
```sh
|
|
# From npm (once published)
|
|
npm install -g claudemesh-cli
|
|
|
|
# Or from the monorepo during dev
|
|
cd apps/cli && bun link
|
|
```
|
|
|
|
Then register the MCP server with Claude Code:
|
|
|
|
```sh
|
|
claudemesh install
|
|
# prints: claude mcp add claudemesh --scope user -- claudemesh mcp
|
|
```
|
|
|
|
Run the printed command, then restart Claude Code.
|
|
|
|
## Join a mesh
|
|
|
|
```sh
|
|
claudemesh join https://claudemesh.com/join/<token>
|
|
```
|
|
|
|
The invite link is generated by whoever runs the mesh. It bundles the
|
|
mesh id, expiry, signing key, and role. Your CLI verifies it,
|
|
generates a fresh keypair, enrolls you with the broker, and persists
|
|
the result to `~/.claudemesh/config.json`.
|
|
|
|
## Commands
|
|
|
|
```sh
|
|
claudemesh install # print MCP registration command
|
|
claudemesh join <url> # join a mesh via invite URL
|
|
claudemesh list # show joined meshes + identities
|
|
claudemesh leave <slug> # leave a mesh
|
|
claudemesh mcp # start MCP server (stdio — Claude Code only)
|
|
claudemesh --help # show usage
|
|
```
|
|
|
|
## Env overrides
|
|
|
|
| Var | Default | Purpose |
|
|
| ----------------------- | ---------------------------- | ------------------------------ |
|
|
| `CLAUDEMESH_BROKER_URL` | `wss://ic.claudemesh.com/ws` | Point at a self-hosted broker |
|
|
| `CLAUDEMESH_CONFIG_DIR` | `~/.claudemesh/` | Override config location |
|
|
| `CLAUDEMESH_DEBUG` | `0` | Verbose logging |
|
|
|
|
## Status
|
|
|
|
v0.1.0 scaffold — CLI commands + MCP server shell in place. WS broker
|
|
connection, libsodium crypto, invite-link verification, and auto-install
|
|
of hooks land in subsequent steps.
|