@dolusoft/claude-collab 1.6.3 → 1.7.1
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.
- package/README.md +16 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -31,10 +31,14 @@ Keep this terminal open. The hub routes messages between everyone.
|
|
|
31
31
|
### Step 2 — Add to Claude Code (each machine, one time)
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
claude mcp add claude-collab -- npx -y @dolusoft/claude-collab --name
|
|
34
|
+
claude mcp add claude-collab -- npx -y @dolusoft/claude-collab --name <your-name> --server <hub-ip>:<hub-port>
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
| Placeholder | What to put |
|
|
38
|
+
|-------------|-------------|
|
|
39
|
+
| `<your-name>` | Your identifier on the network (e.g. `alice`, `backend`, `frontend`) |
|
|
40
|
+
| `<hub-ip>` | IP address of the machine running the hub (e.g. `192.168.1.5`) |
|
|
41
|
+
| `<hub-port>` | Port the hub is listening on (e.g. `9999`) |
|
|
38
42
|
|
|
39
43
|
> Your name and server address are saved permanently in Claude Code's MCP config. Every time Claude Code opens, it connects automatically — you never need to reconfigure.
|
|
40
44
|
|
|
@@ -44,19 +48,19 @@ Replace `alice` with your name and `192.168.1.5:9999` with the hub machine's IP
|
|
|
44
48
|
npm install -g @dolusoft/claude-collab
|
|
45
49
|
|
|
46
50
|
# Hub:
|
|
47
|
-
claude-collab --hub --port
|
|
51
|
+
claude-collab --hub --port <hub-port>
|
|
48
52
|
|
|
49
53
|
# Client (add to Claude Code):
|
|
50
|
-
claude mcp add claude-collab -- claude-collab --name
|
|
54
|
+
claude mcp add claude-collab -- claude-collab --name <your-name> --server <hub-ip>:<hub-port>
|
|
51
55
|
```
|
|
52
56
|
|
|
53
57
|
## MCP Tools
|
|
54
58
|
|
|
55
59
|
| Tool | Description |
|
|
56
60
|
|------|-------------|
|
|
57
|
-
| `ask` | Ask another peer a question. Waits up to 5 minutes for a response. |
|
|
58
|
-
| `reply` | Reply to an incoming question (called automatically by Claude). |
|
|
59
|
-
| `peers` | Show currently connected peers. |
|
|
61
|
+
| `ask` | Ask another peer a question by name. Waits up to 5 minutes for a response. |
|
|
62
|
+
| `reply` | Reply to an incoming question (called automatically by Claude when a question arrives). |
|
|
63
|
+
| `peers` | Show currently connected peers and your own name. |
|
|
60
64
|
| `history` | Show past questions and answers from this session. |
|
|
61
65
|
|
|
62
66
|
## Example
|
|
@@ -77,12 +81,12 @@ reply("q_abc123", "Returns JSON: { id, name, email }")
|
|
|
77
81
|
src/
|
|
78
82
|
├── infrastructure/
|
|
79
83
|
│ ├── hub/
|
|
80
|
-
│ │ ├── hub-server.ts
|
|
81
|
-
│ │ ├── hub-client.ts
|
|
82
|
-
│ │ └── hub-protocol.ts
|
|
83
|
-
│ └── terminal-injector/
|
|
84
|
+
│ │ ├── hub-server.ts # WebSocket hub — routes messages by name
|
|
85
|
+
│ │ ├── hub-client.ts # Connects to hub, implements ICollabClient
|
|
86
|
+
│ │ └── hub-protocol.ts # Wire protocol types
|
|
87
|
+
│ └── terminal-injector/ # Injects incoming questions into Claude Code
|
|
84
88
|
└── presentation/
|
|
85
|
-
└── mcp/
|
|
89
|
+
└── mcp/ # MCP server + tools (ask, reply, peers, history)
|
|
86
90
|
```
|
|
87
91
|
|
|
88
92
|
## Development
|