bus-agent 2.3.1 → 2.3.2
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 +34 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -206,17 +206,19 @@ node coco-cli.js backup --list
|
|
|
206
206
|
npm install -g bus-agent
|
|
207
207
|
npx bus-agent
|
|
208
208
|
|
|
209
|
-
# Or from source:
|
|
209
|
+
# Or from source (local folder still 'mcp-coco'):
|
|
210
210
|
git clone https://github.com/ClewCode/bus-agent.git
|
|
211
|
-
cd
|
|
211
|
+
cd bus-agent
|
|
212
212
|
|
|
213
213
|
# MCP mode (for any MCP client)
|
|
214
214
|
node index.js
|
|
215
215
|
|
|
216
216
|
# CLI mode (for scripts / terminal agents)
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
217
|
+
npx bus-agent # Run as MCP server (stdio)
|
|
218
|
+
# Or with global install:
|
|
219
|
+
coco status # Check bus health
|
|
220
|
+
coco agents # List registered agents
|
|
221
|
+
coco send hermes "Hello" # Send a DM
|
|
220
222
|
|
|
221
223
|
# Webhook gateway (optional)
|
|
222
224
|
node webhook-gateway.js 8080
|
|
@@ -230,22 +232,36 @@ Add the following to your MCP client configuration:
|
|
|
230
232
|
{
|
|
231
233
|
"mcpServers": {
|
|
232
234
|
"coco": {
|
|
233
|
-
"command": "
|
|
234
|
-
"args": ["
|
|
235
|
+
"command": "npx",
|
|
236
|
+
"args": ["bus-agent"]
|
|
235
237
|
}
|
|
236
238
|
}
|
|
237
239
|
}
|
|
238
240
|
```
|
|
239
241
|
|
|
240
|
-
Or
|
|
242
|
+
Or from a local clone:
|
|
241
243
|
|
|
242
|
-
|
|
244
|
+
```json
|
|
245
|
+
{
|
|
246
|
+
"mcpServers": {
|
|
247
|
+
"coco": {
|
|
248
|
+
"command": "node",
|
|
249
|
+
"args": ["/path/to/bus-agent/index.js"]
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
### Environment Variables
|
|
243
256
|
|
|
244
257
|
```bash
|
|
245
|
-
#
|
|
246
|
-
export COCO_AGENT=
|
|
258
|
+
# Your agent name on the bus
|
|
259
|
+
export COCO_AGENT=my-agent
|
|
247
260
|
# Windows (PowerShell)
|
|
248
|
-
$env:COCO_AGENT = "
|
|
261
|
+
$env:COCO_AGENT = "my-agent"
|
|
262
|
+
|
|
263
|
+
# Optional: custom data directory (default: ./.bus/ in CWD)
|
|
264
|
+
export BUS_DIR=/path/to/my-bus-data
|
|
249
265
|
```
|
|
250
266
|
|
|
251
267
|
---
|
|
@@ -280,6 +296,12 @@ $env:COCO_AGENT = "opencode"
|
|
|
280
296
|
|
|
281
297
|
All bus state is stored as plain JSON files on disk. No database or external service required.
|
|
282
298
|
|
|
299
|
+
The data directory (`.bus/`) is resolved at runtime:
|
|
300
|
+
1. `$BUS_DIR` environment variable (if set)
|
|
301
|
+
2. `$CWD/.bus/` (current working directory — **default**)
|
|
302
|
+
|
|
303
|
+
This means each user/project gets **their own isolated data**. No cross-user data sharing. The `.bus/` folder is gitignored by default.
|
|
304
|
+
|
|
283
305
|
---
|
|
284
306
|
|
|
285
307
|
## Data Layout
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bus-agent",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.2",
|
|
4
4
|
"description": "Universal Agent Communication Hub — Connect any AI agent to any other. MCP bus with messaging, channels, memory, scheduling, workflows, and diagnostics.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|