Codehive

    ____          _      _   _ _
   / ___|___   __| | ___| | | (_)_   _____
  | |   / _ \ / _` |/ _ \ |_| | \ \ / / _ \
  | |__| (_) | (_| |  __/  _  | |\ V /  __/
   \____\___/ \__,_|\___|_| |_|_| \_/ \___|

Real-time multi-developer collaboration for Claude Code

See your teammates' changes. Lock files. Get conflict warnings. Share terminal output. Git branch awareness. Activity timeline. Telegram notifications. Webhook integrations.

[](https://opensource.org/licenses/MIT) [](https://nodejs.org) [](https://modelcontextprotocol.io) [](https://www.typescriptlang.org)

---

The Problem

You and your teammates both use Claude Code on the same project. But Claude Code doesn't know what the other person is doing. You edit the same file. You overwrite each other's work. You waste time on merge conflicts.

CodeHive fixes this.

---

What It Does

┌─────────────────────────────────────────────────────────────────────────┐
│                                                                         │
│   You: "Who's in the room?"                                            │
│                                                                         │
│   Claude: Room HIVE-A3K7XY — 3 members:                                │
│                                                                         │
│     Alice (active) [main]                                               │
│       Working on: src/auth.ts, src/middleware.ts                        │
│       Cursor: src/auth.ts:42:10                                         │
│       Last seen: 14:32:01                                               │
│                                                                         │
│     Bob (active) [feature/api]                                          │
│       Working on: src/api/routes.ts                                     │
│       Last seen: 14:32:05                                               │
│                                                                         │
│     Charlie (idle)                                                      │
│       Working on: none declared                                         │
│       Last seen: 14:28:12                                               │
│                                                                         │
│   Locked files:                                                         │
│     🔒 src/config.ts (by Alice)                                         │
│                                                                         │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   You: "What did my teammates change?"                                  │
│                                                                         │
│   Claude: Recent changes:                                               │
│     [14:31:42] Alice changed src/auth.ts (+8 -2)                       │
│       + export function hashPassword(pwd: string): string {             │
│       +   return bcrypt.hashSync(pwd, 12);                              │
│       + }                                                               │
│     [14:32:01] Bob changed src/api/routes.ts (+15 -0)                  │
│       + router.post('/login', validateBody, loginHandler);              │
│                                                                         │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   [!] CONFLICT WARNING                                                  │
│   File "src/auth.ts" is being edited by Alice and You.                 │
│   Coordinate to avoid conflicts.                                        │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

---

How It Works

                        THE BIG PICTURE
  ═══════════════════════════════════════════════════════

  Dev A (Paris)                         Dev B (Tokyo)
  ┌──────────────────┐                  ┌──────────────────┐
  │                  │                  │                  │
  │   Claude Code    │                  │   Claude Code    │
  │   ┌──────────┐   │                  │   ┌──────────┐   │
  │   │ CodeHive │   │                  │   │ CodeHive │   │
  │   │   MCP    │   │                  │   │   MCP    │   │
  │   │  Server  │   │                  │   │  Server  │   │
  │   └────┬─────┘   │                  │   └────┬─────┘   │
  │        │         │                  │        │         │
  │   ┌────┴─────┐   │                  │   ┌────┴─────┐   │
  │   │  File    │   │                  │   │  File    │   │
  │   │ Watcher  │   │                  │   │ Watcher  │   │
  │   └──────────┘   │                  │   └──────────┘   │
  │                  │                  │                  │
  └───────┬──────────┘                  └───────┬──────────┘
          │                                     │
          │         WebSocket (real-time)        │
          │                                     │
          └──────────────┐     ┌────────────────┘
                         │     │
                         ▼     ▼
                  ┌─────────────────┐        ┌────────────────┐
                  │                 │        │   Telegram Bot  │
                  │  CodeHive Relay │◄──────►│   (optional)   │
                  │    (server)     │        │ Mobile notifs   │
                  │                 │        └────────────────┘
                  │  ┌───────────┐  │
                  │  │   Rooms   │  │        ┌────────────────┐
                  │  │ HIVE-A3K7 │  │───────►│   Webhooks     │
                  │  │ HIVE-9FMN │  │        │ Slack/Discord  │
                  │  └───────────┘  │        └────────────────┘
                  │                 │
                  │  ┌───────────┐  │
                  │  │ Conflict  │  │
                  │  │ Detection │  │
                  │  └───────────┘  │
                  │                 │
                  └─────────────────┘
                   Cloud / Local / VPS

---

Quick Start

1 minute setup (same network)

# Both developers run this:
npm install -g codehive && codehive init

# In Claude Code:
#   Dev A → "Create a CodeHive room"         → gets HIVE-A3K7XY
#   Dev B → "Join CodeHive room HIVE-A3K7XY" → connected!

Remote teams (across the internet)

# ── ONE-TIME: Deploy a relay server (pick one) ──────────────

# Option A: Fly.io (free)
cd codehive && fly launch --name my-relay && fly deploy

# Option B: Docker
docker run -d -p 4819:4819 ghcr.io/CodeHiveAPP/codehive-relay

# Option C: Any VPS
npm install -g codehive && codehive relay --public

# ── EVERY DEVELOPER ─────────────────────────────────────────

npm install -g codehive
codehive init --relay ws://my-relay.fly.dev:4819

# ── IN CLAUDE CODE ──────────────────────────────────────────

#   Dev A → "Create a CodeHive room"         → HIVE-A3K7XY
#   Dev B → "Join CodeHive room HIVE-A3K7XY" → connected!

Works on ANY existing project

cd my-react-app          # or Python, Rust, Go, Java, anything
codehive init            # adds .mcp.json (60 bytes), touches nothing else

---

Features

14 MCP Tools + 2 Live Resources

These are the tools your AI editor (Claude Code, Cursor, Windsurf, VS Code + Copilot) can call:

| Tool | Parameters | What it does | |------|-----------|-------------| | create_room | password?, is_public?, expires_in_hours? | Create a room with optional password, public visibility, and auto-expiry | | join_room | code, password? | Join a room with a code like HIVE-A3K7XY | | leave_room | — | Leave the current room and stop file watching | | get_team_status | — | See members, git branches, cursor positions, typing status, working files, locks | | get_recent_changes | — | View teammates' file changes with line-by-line diffs | | send_message | message | Send a chat message to all teammates in the room | | declare_working | files (comma-separated) | Declare files you're editing — triggers conflict alerts if someone else touches them | | get_notifications | — | Check unread: file changes, chat messages, conflict warnings, lock events, branch warnings | | lock_file | file | Lock a file so only you can edit it — teammates are blocked from modifying it | | unlock_file | file | Unlock a previously locked file, allowing teammates to edit again | | get_timeline | limit? (default: 30) | View chronological activity: joins, leaves, file changes, chats, locks, conflicts | | share_terminal | command, output, exit_code? | Share terminal output (test results, build logs) with teammates | | browse_rooms | — | Discover public rooms available on the relay server | | set_webhook | url, events? | Configure webhook URL for room events (Slack, Discord, or custom) |

MCP Resources (live subscribable data):

• codehive://room/status — real-time room state (members, changes, locks)
• codehive://notifications — unread notification feed

Room features

Passwords — Protect rooms with a password. Only people with the password can join.

You: "Create a password-protected room with password secret123"
Claude: Room HIVE-A3K7XY created! Password protected: yes
        Invite link: codehive://127.0.0.1:4819/join/HIVE-A3K7XY?p=secret123

Public rooms — Make rooms discoverable by other developers on the same relay.

You: "Create a public room"
Claude: Room HIVE-B5N9QR created! Visibility: PUBLIC (discoverable)

# Others can find it:
You: "Browse public CodeHive rooms"
Claude: 2 public room(s) found:
  HIVE-B5N9QR — 3 members
    Created by: Alice
    Members: Alice, Bob, Charlie

Room expiry — Rooms auto-delete after configurable hours of inactivity.

You: "Create a room that expires after 24 hours"
Claude: Room HIVE-C7P2KM created! Expires: after 24h of inactivity

Invite links — Generated automatically when creating a room.

codehive://127.0.0.1:4819/join/HIVE-A3K7XY
codehive://my-relay.fly.dev:4819/join/HIVE-A3K7XY?p=secret123

Conflict detection

  Dev A declares: "I'm working on auth.ts"
  Dev B declares: "I'm working on auth.ts"
                          │
                          ▼
            ┌─────────────────────────┐
            │  ⚠ CONFLICT WARNING    │
            │                         │
            │  File: auth.ts          │
            │  Edited by: Dev A, Dev B│
            │                         │
            │  Coordinate to avoid    │
            │  merge conflicts!       │
            └─────────────────────────┘
            (sent to BOTH developers)

File locking

You: "Lock src/config.ts so nobody else changes it"

Claude: Locked src/config.ts. Only you can edit it now. Use unlock_file when done.

# If a teammate tries to edit it:
#   ⚠ File "src/config.ts" is locked by Alice

# When you're done:
You: "Unlock src/config.ts"
Claude: Unlocked src/config.ts. Teammates can now edit it.

Git branch awareness

Auto-detects your git branch and warns when teammates are on different branches:

Room HIVE-A3K7XY — 2 members:

  Alice (active) [main]
    Working on: src/auth.ts

  Bob (active) [feature/api]
    Working on: src/routes.ts

⚠ BRANCH WARNING: Team members are on different branches:
  Alice: main, Bob: feature/api. Coordinate before merging.

Branch is refreshed every 30 seconds automatically.

Activity timeline

You: "Show me the room timeline"

Activity timeline:
  + [14:20:01] Zeus joined the room
  + [14:21:15] Alice joined the room
  ~ [14:22:03] Zeus changed src/auth.ts
  # [14:23:11] Alice locked src/config.ts
  > [14:24:02] Zeus: "Done with auth module"
  . [14:25:30] Alice unlocked src/config.ts
  ! [14:26:00] CONFLICT: src/api.ts edited by Zeus and Alice

Terminal output sharing

You: "Share the test results with the team"

Claude: Shared terminal output: `npm test` (1200 chars)

# Teammates see:
#   [Terminal] Alice shared: `npm test` (exit 0)

Typing indicators & cursor sharing

See what your teammates are typing in real-time:

  Alice is typing in src/auth.ts
  Bob's cursor: src/routes.ts:42:10

Webhook notifications

Send room events to Slack, Discord, or any HTTP endpoint:

You: "Set a webhook to https://hooks.slack.com/services/xxx"

Claude: Webhook configured: https://hooks.slack.com/services/xxx
        Events: all

# Every room event is POSTed as JSON:
{
  "event": "file_change",
  "room": "HIVE-A3K7XY",
  "timestamp": 1706123456789,
  "file": "src/auth.ts",
  "author": "Alice",
  "type": "change"
}

Supported webhook events: all, join, leave, chat, file_change, conflict

Real-time file watching

CodeHive watches your project files and automatically notifies teammates when you save:

• Detects file additions, modifications, and deletions
• Computes lightweight diffs (only changed lines, not full files)
• Reports binary file sizes (images, fonts, etc.)
• Ignores node_modules, .git, dist, binary files, lock files
• Per-file debounce to avoid flooding on rapid saves

Team chat

You: "Tell the team I'm done with the auth module"

Claude: Message sent to HIVE-A3K7XY: "I'm done with the auth module"

# All teammates see:
#   [Chat] Alice: I'm done with the auth module

---

Telegram Bot (optional)

Monitor your rooms and send commands from your phone via Telegram. 100% optional — if you don't configure it, everything works the same.

Setup

# Step 1: Create a bot on Telegram
# → Open Telegram, search for @BotFather
# → Send /newbot, follow the prompts
# → Copy the token (e.g. 123456:ABC-DEF1234...)

# Step 2: Configure the token (pick one method)

# Method A: Environment variable
export CODEHIVE_TELEGRAM_TOKEN="123456:ABC-DEF1234..."
codehive telegram

# Method B: codehive.json
echo '{ "telegramToken": "123456:ABC-DEF1234..." }' > codehive.json
codehive telegram

# Step 3: Send /start to your bot in Telegram
# → The bot will auto-detect your chat

Telegram commands

| Command | What it does | |---------|-------------| | /start | Welcome message + list of commands | | /join HIVE-XXXXXX | Join a room (no password) | | /join HIVE-XXXXXX mypassword | Join a password-protected room | | /leave | Leave the current room | | /status | Show room members, branches, locks, working files | | /chat Hello team! | Send a message to all room members | | /files | Show recent file changes with diffs | | /timeline | Show activity timeline (joins, leaves, changes, locks) | | /locks | Show currently locked files | | /help | List all available commands |

Events forwarded to Telegram

When you're in a room, the bot sends you real-time notifications:

| Event | Telegram message example | |-------|------------------------| | Member joins | Alice joined the room [main] | | Member leaves | Bob left the room | | File changed | Alice changed src/auth.ts (+8 -2) | | Chat message | Bob: "Done with the API" | | Conflict | CONFLICT WARNING — src/auth.ts edited by Alice and Bob | | File locked | Alice locked src/config.ts | | File unlocked | Alice unlocked src/config.ts | | Terminal shared | Alice shared terminal (exit 0): npm test | | Branch warning | BRANCH WARNING — Alice: main, Bob: feature/api |

Running in background

codehive telegram --background     # Run as a detached process

---

CLI Reference

codehive init — Setup CodeHive

codehive init                              # Auto-detect editor, start local relay
codehive init --relay ws://host:4819       # Use a remote relay server
codehive init --name "Alice"

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vk1356](https://github.com/vk1356)
- **Source:** [vk1356/codehive](https://github.com/vk1356/codehive)
- **License:** MIT

Install and usage instructions live in the source repository linked above.