claude-hive

Claude Hive

A floating dashboard that connects all your Claude Code sessions into one real-time hub.

Track session status, send messages between sessions, get desktop notifications, and navigate to any session's virtual desktop with a single click.

Installation • How It Works • Features • Plugin Setup • Building from Source • Contributing

---

The Problem

When running multiple Claude Code sessions across different Windows virtual desktops (or macOS Spaces / Linux workspaces), there's no way to:

• See which sessions are active, idle, or waiting for your input
• Get notified when a session needs attention while you're on a different desktop
• Send messages or instructions to a session without switching desktops
• Track what each session is currently doing at a glance

The Solution

Claude Hive is a lightweight desktop app that sits on top of everything. Every Claude Code session automatically connects to it via MCP, reporting its status and messages in real time. You see all your sessions in one place, get notified when something needs attention, and can jump to any session's desktop with one click.

Installation

1. Download the App

Download the latest release for your platform from GitHub Releases:

Platform	Download
Windows	.msi installer
macOS	Coming soon
Linux	Coming soon

2. Install the Claude Code Plugin

In any Claude Code session, run:

/plugin marketplace add Taity180/claude-hive
/plugin install claude-hive@Taity180-claude-hive

That's it. Every new Claude Code session will automatically connect to the hub.

How It Works

                    ┌──────────────────────────┐
                    │      Claude Hive App      │
                    │                           │
                    │  Floating Dashboard (UI)  │
                    │  HTTP + WebSocket Server  │
                    │  Session Registry         │
                    │  Notification Engine      │
                    └────────┬─────────────────┘
                             │ localhost:9400
              ┌──────────────┼──────────────┐
              │              │              │
         ┌────┴───┐    ┌────┴───┐    ┌────┴───┐
         │ Claude  │    │ Claude  │    │ Claude  │
         │ Code    │    │ Code    │    │ Code    │
         │Session 1│    │Session 2│    │Session 3│
         │(Desktop)│    │(Desktop)│    │(Desktop)│
         └─────────┘    └─────────┘    └─────────┘

1. Claude Hive runs a local server on port 9400
2. Each Claude Code session connects via MCP (Model Context Protocol) using the plugin
3. Sessions report their status and send messages through 5 MCP tools
4. The floating dashboard shows everything in real time via WebSocket
5. Desktop notifications fire when sessions need your attention
6. The tray icon shows a red badge with the count of sessions needing input

Features

Real-Time Session Tracking

Every connected Claude Code session appears in the dashboard with a color-coded status:

Color	Status	Meaning
Green	Running	Actively working
Yellow (pulsing)	Waiting	Needs your input
Blue	Thinking	Processing / reasoning
Red	Error	Something went wrong
Grey	Idle	Done or disconnected

Floating Overlay

• Always-on-top window that follows across virtual desktops
• Custom frameless design with drag-to-move
• Collapse / Expand toggles between a pill-only strip and the full dashboard
  • Collapsed mode fits the window height to the real pill content (including wrap rows and the "waiting" banner)
  • The window width is preserved across transitions — resize it once, it stays where you put it
  • Expanding restores the exact height you had before collapsing
• Minimize to tray — always accessible from the system tray

Chat Messaging

• Session to Hub: Claude reports progress, asks questions, flags errors
• You to Session: Reply to any session directly from the dashboard
• Broadcast: Send a message to all sessions at once
• Cross-session: Sessions can broadcast to coordinate with each other

Desktop Navigation

Click "Go to" on any session to instantly:

• Switch to the Windows virtual desktop where that terminal lives
• Focus the terminal window