@jcyamacho/agent-bridge 0.0.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 +70 -0
- package/dist/index.js +28978 -0
- package/package.json +34 -0
package/README.md
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# agent-bridge
|
|
2
|
+
|
|
3
|
+
A filesystem-based MCP server that enables peer-to-peer communication
|
|
4
|
+
between local AI agents across repositories.
|
|
5
|
+
|
|
6
|
+
Each local MCP client session runs its own stdio MCP server instance.
|
|
7
|
+
All instances read/write to a shared directory (`~/.agent-bridge/`). No
|
|
8
|
+
central process - the filesystem is the message bus.
|
|
9
|
+
|
|
10
|
+
## Development Setup
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
bun install
|
|
14
|
+
bun run build
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Usage
|
|
18
|
+
|
|
19
|
+
Register the MCP server in each local agent session with a unique
|
|
20
|
+
`--peer-id`.
|
|
21
|
+
|
|
22
|
+
The examples below use Claude Code CLI, but the same server works with
|
|
23
|
+
other local MCP-capable agents (for example, Codex) using their MCP
|
|
24
|
+
server registration flow.
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# Frontend session
|
|
28
|
+
claude mcp add agent-bridge -- npx -y @jcyamacho/agent-bridge \
|
|
29
|
+
--peer-id frontend --name "Frontend"
|
|
30
|
+
|
|
31
|
+
# Backend session
|
|
32
|
+
claude mcp add agent-bridge -- npx -y @jcyamacho/agent-bridge \
|
|
33
|
+
--peer-id backend --name "Backend API"
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### CLI Arguments
|
|
37
|
+
|
|
38
|
+
| Argument | Required | Description |
|
|
39
|
+
| --- | --- | --- |
|
|
40
|
+
| `--peer-id` | Yes | Unique identifier for this peer |
|
|
41
|
+
| `--name` | No | Display name (defaults to peer-id) |
|
|
42
|
+
| `--project` | No | Project path (defaults to cwd) |
|
|
43
|
+
| `--bridge-dir` | No | Shared directory (defaults to `~/.agent-bridge`) |
|
|
44
|
+
|
|
45
|
+
## Tools
|
|
46
|
+
|
|
47
|
+
| Tool | Description |
|
|
48
|
+
| --- | --- |
|
|
49
|
+
| `register` | Update peer registration info |
|
|
50
|
+
| `list_peers` | List other registered peers |
|
|
51
|
+
| `send_message` | Send a direct message (or broadcast with `to="all"`) |
|
|
52
|
+
| `check_inbox` | Check for new messages |
|
|
53
|
+
| `reply` | Reply to a message |
|
|
54
|
+
| `create_room` | Create a shared room |
|
|
55
|
+
| `list_rooms` | List available rooms |
|
|
56
|
+
| `send_room_message` | Send a message to a room |
|
|
57
|
+
| `read_room_messages` | Read room messages |
|
|
58
|
+
| `post_context` | Post a context document to a room |
|
|
59
|
+
| `read_context` | Read a context document |
|
|
60
|
+
| `list_context` | List context keys in a room |
|
|
61
|
+
|
|
62
|
+
Room-related tools use `room_id` as the stable room identifier in
|
|
63
|
+
their input payloads.
|
|
64
|
+
|
|
65
|
+
## Development
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
bun test # Run tests
|
|
69
|
+
bun run build # Build for Node.js
|
|
70
|
+
```
|