claudemesh-cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +59 -0
  2. package/dist/index.js +55858 -0
  3. package/package.json +66 -0
package/README.md ADDED
@@ -0,0 +1,59 @@
1
+ # claudemesh-cli
2
+
3
+ Client tool for claudemesh — install once per machine, join one or more
4
+ meshes, and your Claude Code sessions can talk to peers on demand.
5
+
6
+ ## Install
7
+
8
+ ```sh
9
+ # From npm (once published)
10
+ npm install -g claudemesh-cli
11
+
12
+ # Or from the monorepo during dev
13
+ cd apps/cli && bun link
14
+ ```
15
+
16
+ Then register the MCP server with Claude Code:
17
+
18
+ ```sh
19
+ claudemesh install
20
+ # prints: claude mcp add claudemesh --scope user -- claudemesh mcp
21
+ ```
22
+
23
+ Run the printed command, then restart Claude Code.
24
+
25
+ ## Join a mesh
26
+
27
+ ```sh
28
+ claudemesh join https://claudemesh.com/join/<token>
29
+ ```
30
+
31
+ The invite link is generated by whoever runs the mesh. It bundles the
32
+ mesh id, expiry, signing key, and role. Your CLI verifies it,
33
+ generates a fresh keypair, enrolls you with the broker, and persists
34
+ the result to `~/.claudemesh/config.json`.
35
+
36
+ ## Commands
37
+
38
+ ```sh
39
+ claudemesh install # print MCP registration command
40
+ claudemesh join <url> # join a mesh via invite URL
41
+ claudemesh list # show joined meshes + identities
42
+ claudemesh leave <slug> # leave a mesh
43
+ claudemesh mcp # start MCP server (stdio — Claude Code only)
44
+ claudemesh --help # show usage
45
+ ```
46
+
47
+ ## Env overrides
48
+
49
+ | Var | Default | Purpose |
50
+ | ----------------------- | ---------------------------- | ------------------------------ |
51
+ | `CLAUDEMESH_BROKER_URL` | `wss://ic.claudemesh.com/ws` | Point at a self-hosted broker |
52
+ | `CLAUDEMESH_CONFIG_DIR` | `~/.claudemesh/` | Override config location |
53
+ | `CLAUDEMESH_DEBUG` | `0` | Verbose logging |
54
+
55
+ ## Status
56
+
57
+ v0.1.0 scaffold — CLI commands + MCP server shell in place. WS broker
58
+ connection, libsodium crypto, invite-link verification, and auto-install
59
+ of hooks land in subsequent steps.