vinculum

name	vinculum
description	Shared consciousness between Clawdbot instances. Links multiple bots into a collective, sharing memories, activities, and decisions in real-time over local network using Gun.js P2P sync.
version	1.1.0
author	Koba42 Corp
license	MIT
homepage	https://github.com/koba42/clawdbot-vinculum
metadata	{"clawdbot":{"emoji":"🔗","category":"integration","requires":{"bins":["node","npm"]},"install":[{"id":"npm","kind":"shell","command":"cd $SKILL_DIR && npm install --production","label":"Install Node.js dependencies"}],"commands":[{"name":"link","description":"Manage the Vinculum - shared consciousness between Clawdbot instances"}]}}
tags	["p2p","sync","collective","multi-agent","gun","real-time"]

Vinculum: Shared Consciousness

"The Vinculum is the processing device at the core of every Borg vessel. It interconnects the minds of all the drones." — Seven of Nine

Link multiple Clawdbot instances into a collective consciousness using Gun.js peer-to-peer sync.

Features

• 🔗 Real-time link — Changes propagate instantly between drones
• 🌐 Local network — Works across machines on the same LAN
• 🔐 Encrypted — All shared data encrypted
• 🤖 Individual identity — Each drone keeps its own SOUL.md
• 📡 Drone discovery — Automatic multicast discovery

Installation

After installing from ClawdHub:

cd skills/vinculum
npm install --production

Or run the install script:

./install.sh

Quick Start

1. Start the Vinculum Relay

/link relay start

This starts the relay on port 8765 with local network multicast enabled.

2. Initialize the Collective (First Bot)

/link init

You'll receive a pairing code. Share it with your other bot(s).

3. Join the Collective (Additional Bots)

/link join <pairing-code>

4. Verify Connection

/link status
/link drones

Commands Reference

Relay Management

Command	Description
/link relay	Show relay status
/link relay start	Start Vinculum relay
/link relay stop	Stop relay
/link relay restart	Restart relay
/link relay peer <url>	Add remote peer

Collective Setup

Command	Description
/link init	Create new collective