@raysonmeng/agentbridge 0.1.0

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@raysonmeng/agentbridge",
+  "version": "0.1.0",
+  "description": "Bridge between Claude Code and Codex — bidirectional agent communication via MCP Channel + JSON-RPC",
+  "type": "module",
+  "bin": {
+    "agentbridge": "dist/cli.js",
+    "abg": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "plugins/",
+    ".claude-plugin/",
+    "scripts/postinstall.cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "bun run src/bridge.ts",
+    "build:cli": "mkdir -p dist && bun build src/cli.ts --outfile dist/cli.js --target bun && chmod +x dist/cli.js",
+    "build:plugin": "mkdir -p plugins/agentbridge/server && bun build src/bridge.ts --outfile plugins/agentbridge/server/bridge-server.js --target bun && bun build src/daemon.ts --outfile plugins/agentbridge/server/daemon.js --target bun",
+    "postinstall": "node scripts/postinstall.cjs",
+    "prepublishOnly": "bun run build:cli && bun run build:plugin",
+    "validate:plugin": "claude plugin validate plugins/agentbridge && claude plugin validate .claude-plugin/marketplace.json",
+    "test": "bun test src",
+    "typecheck": "tsc --noEmit",
+    "validate:plugin-versions": "bun scripts/check-plugin-versions.js",
+    "check": "tsc --noEmit && bun test src && bun run build:plugin && bun scripts/check-plugin-versions.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/raysonmeng/agent-bridge.git"
+  },
+  "homepage": "https://github.com/raysonmeng/agent-bridge#readme",
+  "bugs": {
+    "url": "https://github.com/raysonmeng/agent-bridge/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "codex",
+    "mcp",
+    "agent",
+    "bridge",
+    "multi-agent",
+    "channels"
+  ],
+  "author": "AgentBridge Contributors",
+  "license": "MIT",
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@types/bun": "^1.3.11",
+    "typescript": "^5.8.0"
+  }
+}

package/plugins/agentbridge/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "agentbridge",
+  "version": "0.1.0",
+  "description": "Bridge Claude Code and Codex with a shared daemon, push channel delivery, and bidirectional reply tooling.",
+  "author": {
+    "name": "AgentBridge Contributors",
+    "email": "raysonmeng@qq.com"
+  },
+  "homepage": "https://github.com/raysonmeng/agent-bridge#readme",
+  "repository": "https://github.com/raysonmeng/agent-bridge",
+  "license": "MIT"
+}

package/plugins/agentbridge/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "agentbridge": {
+      "command": "bun",
+      "args": ["run", "${CLAUDE_PLUGIN_ROOT}/server/bridge-server.js"],
+      "env": {
+        "AGENTBRIDGE_DAEMON_ENTRY": "./daemon.js"
+      }
+    }
+  }
+}

package/plugins/agentbridge/README.md

@@ -0,0 +1,43 @@
+# AgentBridge Plugin
+
+Claude Code plugin for AgentBridge. This plugin packages the AgentBridge MCP frontend, dual-mode Claude transport (push channel delivery plus pull-mode `get_messages`), the `/agentbridge:init` command, and a non-blocking SessionStart health check.
+
+## Structure
+
+```text
+plugins/agentbridge/
+├── .claude-plugin/plugin.json
+├── .mcp.json
+├── commands/init.md
+├── hooks/hooks.json
+├── scripts/health-check.sh
+└── server/
+    ├── bridge-server.js
+    └── daemon.js
+```
+
+## Build
+
+Run:
+
+```bash
+bun run build:plugin
+```
+
+This creates self-contained bundles at:
+
+- `plugins/agentbridge/server/bridge-server.js`
+- `plugins/agentbridge/server/daemon.js`
+
+## Local Testing
+
+1. Build the plugin bundles: `bun run build:plugin`
+2. In Claude Code, load the plugin from this repo or install it from the marketplace manifest in `.claude-plugin/marketplace.json`
+3. Reload plugins in the active session with `/reload-plugins`
+
+## Notes
+
+- The plugin frontend launches the sibling daemon bundle via `AGENTBRIDGE_DAEMON_ENTRY=./daemon.js`.
+- Claude delivery supports both push notifications and pull-mode polling via `get_messages`, depending on the runtime mode.
+- The SessionStart hook is informational only. It never starts or stops the daemon.
+- The command at `/agentbridge:init` edits project-local `.agentbridge/` files only; plugin installation and marketplace registration remain terminal-side tasks (`agentbridge init` / `agentbridge dev`).

package/plugins/agentbridge/commands/init.md

@@ -0,0 +1,70 @@
+---
+description: Create or update the AgentBridge project config files in the current workspace
+allowed-tools: Read,Write,Edit,MultiEdit,LS
+---
+
+Bootstrap or update AgentBridge's project-local configuration in this workspace.
+
+Follow these rules:
+
+1. Work only inside `.agentbridge/`.
+2. Do not install plugins or modify `.claude/settings.json` here. Plugin setup belongs to terminal workflows: `agentbridge init` attempts best-effort plugin installation, and `agentbridge dev` handles local marketplace registration/sync.
+3. Preserve user edits when the files already exist. Update only the fields the user asked to change.
+4. Keep `.agentbridge/config.json` valid JSON.
+5. Keep `.agentbridge/collaboration.md` human-editable and concise.
+
+If `.agentbridge/config.json` is missing, create it with this default template:
+
+```json
+{
+  "version": "1.0",
+  "daemon": {
+    "port": 4500,
+    "proxyPort": 4501
+  },
+  "agents": {
+    "claude": {
+      "role": "Reviewer, Planner",
+      "mode": "push"
+    },
+    "codex": {
+      "role": "Implementer, Executor"
+    }
+  },
+  "markers": ["IMPORTANT", "STATUS", "FYI"],
+  "turnCoordination": {
+    "attentionWindowSeconds": 15,
+    "busyGuard": true
+  },
+  "idleShutdownSeconds": 30
+}
+```
+
+If `.agentbridge/collaboration.md` is missing, create it with this default template:
+
+```markdown
+# Collaboration Rules
+
+## Roles
+- Claude: Reviewer, Planner, Hypothesis Challenger
+- Codex: Implementer, Executor, Reproducer/Verifier
+
+## Thinking Patterns
+- Analytical/review tasks: Independent Analysis & Convergence
+- Implementation tasks: Architect -> Builder -> Critic
+- Debugging tasks: Hypothesis -> Experiment -> Interpretation
+
+## Communication
+- Use explicit phrases: "My independent view is:", "I agree on:", "I disagree on:", and "Current consensus:"
+- Tag messages with [IMPORTANT], [STATUS], or [FYI]
+
+## Review Process
+- Cross-review: author never reviews their own code
+- All changes go through feature/fix branches + PR
+- Merge via squash merge
+
+## Custom Rules
+<!-- Add project-specific collaboration rules here -->
+```
+
+When you finish, briefly summarize what changed and point the user to the two files you updated.

package/plugins/agentbridge/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "description": "Hint-only health checks for AgentBridge startup. These hooks never orchestrate the daemon.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/health-check.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/agentbridge/scripts/health-check.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+
+set -uo pipefail
+
+INPUT="$(cat 2>/dev/null || true)"
+
+workspace="${CLAUDE_PROJECT_DIR:-${PWD}}"
+cooldown_seconds="${AGENTBRIDGE_HEALTH_HOOK_COOLDOWN_SECONDS:-120}"
+state_root="${AGENTBRIDGE_HOOK_STATE_DIR:-${TMPDIR:-/tmp}/agentbridge-hooks}"
+port="${AGENTBRIDGE_CONTROL_PORT:-4502}"
+
+if ! command -v curl >/dev/null 2>&1; then
+  exit 0
+fi
+
+mkdir -p "$state_root" 2>/dev/null || true
+workspace_key="$(printf '%s' "$workspace" | cksum | awk '{print $1}')"
+stamp_file="${state_root}/sessionstart-${workspace_key}.stamp"
+now="$(date +%s)"
+
+if [ -f "$stamp_file" ]; then
+  last_notice="$(cat "$stamp_file" 2>/dev/null || echo 0)"
+  if [ $((now - last_notice)) -lt "$cooldown_seconds" ]; then
+    exit 0
+  fi
+fi
+
+printf '%s' "$now" >"$stamp_file" 2>/dev/null || true
+
+health_json="$(curl -fsS --max-time 1 "http://127.0.0.1:${port}/healthz" 2>/dev/null || true)"
+
+if [ -n "$health_json" ]; then
+  tui_connected="false"
+  if printf '%s' "$health_json" | grep -q '"tuiConnected":true'; then
+    tui_connected="true"
+  fi
+
+  if [ "$tui_connected" = "true" ]; then
+    cat <<EOF
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge is running. Daemon healthy, Codex TUI connected. Bridge is ready for communication."}}
+EOF
+  else
+    cat <<EOF
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge daemon is running but Codex TUI is not connected yet. Start Codex in another terminal with: agentbridge codex"}}
+EOF
+  fi
+else
+  cat <<EOF
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"AgentBridge daemon is not reachable on http://127.0.0.1:${port}/healthz yet. Start the bridge with: agentbridge claude (this terminal) + agentbridge codex (another terminal). If you're already using agentbridge claude, the daemon may still be starting up."}}
+EOF
+fi