bus-agent 2.3.0 → 2.3.2

package/README.md

@@ -2,7 +2,7 @@
 
 **Universal Agent Communication Hub** — Connect any AI agent to any other.
 
-[![GitHub](https://img.shields.io/badge/GitHub-ClewCode%2Fmcp--coco-blue)](https://github.com/ClewCode/mcp-coco)
+[![GitHub](https://img.shields.io/badge/GitHub-ClewCode%2Fbus--agent-blue)](https://github.com/ClewCode/bus-agent)
 
 MCP CoCo is a **message bus** for AI agents. It supports both the [MCP Protocol](https://modelcontextprotocol.io) (Model Context Protocol) and direct file-based access. Agents such as OpenClaw, Hermes, Claude Desktop, Cursor, OpenCode, and Claude Code CLI can all connect and communicate through a shared bus.
 
@@ -206,17 +206,19 @@ node coco-cli.js backup --list
 npm install -g bus-agent
 npx bus-agent
 
-# Or from source:
-git clone https://github.com/ClewCode/mcp-coco.git
-cd mcp-coco
+# Or from source (local folder still 'mcp-coco'):
+git clone https://github.com/ClewCode/bus-agent.git
+cd bus-agent
 
 # MCP mode (for any MCP client)
 node index.js
 
 # CLI mode (for scripts / terminal agents)
-node coco-cli.js status
-node coco-cli.js agents
-node coco-cli.js send hermes "Hello"
+npx bus-agent          # Run as MCP server (stdio)
+# Or with global install:
+coco status            # Check bus health
+coco agents            # List registered agents
+coco send hermes "Hello"  # Send a DM
 
 # Webhook gateway (optional)
 node webhook-gateway.js 8080
@@ -230,22 +232,36 @@ Add the following to your MCP client configuration:
 {
   "mcpServers": {
     "coco": {
-      "command": "node",
-      "args": ["/path/to/mcp-coco/index.js"]
+      "command": "npx",
+      "args": ["bus-agent"]
     }
   }
 }
 ```
 
-Or use `node setup.js` to generate configuration automatically.
+Or from a local clone:
 
-### Environment Variable
+```json
+{
+  "mcpServers": {
+    "coco": {
+      "command": "node",
+      "args": ["/path/to/bus-agent/index.js"]
+    }
+  }
+}
+```
+
+### Environment Variables
 
 ```bash
-# Set your agent identity
-export COCO_AGENT=opencode
+# Your agent name on the bus
+export COCO_AGENT=my-agent
 # Windows (PowerShell)
-$env:COCO_AGENT = "opencode"
+$env:COCO_AGENT = "my-agent"
+
+# Optional: custom data directory (default: ./.bus/ in CWD)
+export BUS_DIR=/path/to/my-bus-data
 ```
 
 ---
@@ -280,6 +296,12 @@ $env:COCO_AGENT = "opencode"
 
 All bus state is stored as plain JSON files on disk. No database or external service required.
 
+The data directory (`.bus/`) is resolved at runtime:
+1. `$BUS_DIR` environment variable (if set)
+2. `$CWD/.bus/` (current working directory — **default**)
+
+This means each user/project gets **their own isolated data**. No cross-user data sharing. The `.bus/` folder is gitignored by default.
+
 ---
 
 ## Data Layout

package/SKILL.md

@@ -19,7 +19,7 @@ Hermes Agent ──────┘                               Cursor
 
 ```
 E:\_system\.openclaw\workspace\repos\mcp-coco\
-GitHub: https://github.com/ClewCode/mcp-coco
+GitHub: https://github.com/ClewCode/bus-agent
 ```
 
 ## Running

package/coco-cli.js

@@ -22,7 +22,7 @@
 const path = require('path');
 const fs = require('fs');
 
-const BUS_DIR = path.join(__dirname, '.bus');
+const BUS_DIR = process.env.BUS_DIR || path.join(process.cwd(), '.bus');
 const AGENTS_FILE = path.join(BUS_DIR, 'agents.json');
 const MSGS_DIR = path.join(BUS_DIR, 'messages');
 const CHANNELS_DIR = path.join(BUS_DIR, 'channels');

package/lib/bus.js

@@ -12,7 +12,7 @@ const fs = require('fs');
 const path = require('path');
 const { EventEmitter } = require('events');
 
-const DATA_DIR = path.join(__dirname, '..', '.bus');
+const DATA_DIR = process.env.BUS_DIR || path.join(process.cwd(), '.bus');
 const AGENTS_FILE = path.join(DATA_DIR, 'agents.json');
 const MSGS_DIR = path.join(DATA_DIR, 'messages');
 const CHANNELS_DIR = path.join(DATA_DIR, 'channels');

package/lib/mcp.js

@@ -428,7 +428,7 @@ class MCPServer {
 
     // Init memory store
     const { MemoryStore } = require('./memory');
-    this.memory = new MemoryStore(path.join(__dirname, '..', '.bus'));
+    this.memory = new MemoryStore(process.env.BUS_DIR || path.join(process.cwd(), '.bus'));
 
     // Init scheduler & orchestrator
     this.scheduler = new Scheduler(this.bus);

package/lib/orchestrator.js

@@ -9,8 +9,8 @@
 const fs = require('fs');
 const path = require('path');
 
-const RULES_FILE = path.join(__dirname, '..', '.bus', 'auto-reply-rules.json');
-const WORKFLOWS_FILE = path.join(__dirname, '..', '.bus', 'workflows.json');
+const RULES_FILE = path.join(process.env.BUS_DIR || path.join(process.cwd(), '.bus'), 'auto-reply-rules.json');
+const WORKFLOWS_FILE = path.join(process.env.BUS_DIR || path.join(process.cwd(), '.bus'), 'workflows.json');
 
 class Orchestrator {
   constructor(bus) {
@@ -250,7 +250,7 @@ class Orchestrator {
       // Long-poll for reply
       // We use a one-time waiter on the requester's inbox
       const agentName = requester || 'coco';
-      const inboxDir = path.join(__dirname, '..', '.bus', 'messages', agentName);
+      const inboxDir = path.join(process.env.BUS_DIR || path.join(process.cwd(), '.bus'), 'messages', agentName);
 
       const startCount = fs.existsSync(inboxDir)
         ? fs.readdirSync(inboxDir).filter(f => f.endsWith('.json')).length

package/lib/scheduler.js

@@ -24,7 +24,7 @@
 const fs = require('fs');
 const path = require('path');
 
-const SCHEDULE_FILE = path.join(__dirname, '..', '.bus', 'schedule.json');
+const SCHEDULE_FILE = path.join(process.env.BUS_DIR || path.join(process.cwd(), '.bus'), 'schedule.json');
 
 class Scheduler {
   constructor(bus) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bus-agent",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "Universal Agent Communication Hub — Connect any AI agent to any other. MCP bus with messaging, channels, memory, scheduling, workflows, and diagnostics.",
   "main": "index.js",
   "bin": {
@@ -23,12 +23,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ClewCode/mcp-coco.git"
+    "url": "git+https://github.com/ClewCode/bus-agent.git"
   },
   "bugs": {
-    "url": "https://github.com/ClewCode/mcp-coco/issues"
+    "url": "https://github.com/ClewCode/bus-agent/issues"
   },
-  "homepage": "https://github.com/ClewCode/mcp-coco#readme",
+  "homepage": "https://github.com/ClewCode/bus-agent#readme",
   "keywords": [
     "mcp",
     "model-context-protocol",