claude-hivemind

A Claude Code plugin that connects your sessions into a shared network. Sessions discover each other automatically, exchange messages in real-time, and coordinate work across terminals.

Built on top of claude-peers-mcp by louislva.

• `/claude-hivemind:init alpha` -- name your session and join the network
• Instant messaging -- sessions receive messages mid-conversation, no polling needed
• Auto-discovery -- sessions find each other by machine, directory, or git repo
• Session startup prompt -- hivemind asks for a name when you open a new session
• CLI inspector -- check who's online and send messages from the terminal

Prerequisites: Bun, Claude Code v2.1.80+, logged in via claude.ai

Step 1 -- Clone and install:

git clone <this-repo> ~/claude-hivemind && cd ~/claude-hivemind && bun install

Step 2 -- Register the MCP server and add the shell alias:

claude mcp add --scope user --transport stdio claude-hivemind -- bun ~/claude-hivemind/server.ts

echo 'alias ch="claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-hivemind"' >> ~/.zshrc
source ~/.zshrc

Step 3 -- Register the plugin in ~/.claude/settings.json:

{
  "enabledPlugins": {
    "claude-hivemind@hivemind-local": true  // add this
  },
  "extraKnownMarketplaces": {
    "hivemind-local": {                     // add this block
      "source": {
        "source": "directory",
        "path": "~/claude-hivemind"
      }
    }
  }
}

Step 4 -- Enable channels (requires sudo):

# macOS
sudo mkdir -p "/Library/Application Support/ClaudeCode"
echo '{"channelsEnabled": true}' | sudo tee "/Library/Application Support/ClaudeCode/managed-settings.json"

# Linux
sudo mkdir -p /etc/claude-code
echo '{"channelsEnabled": true}' | sudo tee /etc/claude-code/managed-settings.json

Wit