Skip to content

wandb/hivemind

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

W&B HiveMind

W&B HiveMind is a shared dashboard for AI coding sessions. A lightweight daemon runs on each developer's machine, watches for coding agent activity, and sends session transcripts to hivemind.wandb.tools.

Coding agents like Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot CLI, and Pi all write transcripts to the local filesystem as they work. The HiveMind daemon wakes up every 30 seconds, checks for new activity, and uploads anything it finds. There's nothing to configure per agent. If the agent writes transcripts, HiveMind picks them up.

This repository hosts release binaries for the HiveMind daemon and is the public issue tracker. Found a bug or have a feature request? Open an issue. The dashboard and docs live at hivemind.wandb.tools.

Getting started

Install the client and start the daemon. hivemind start registers a background service (launchd on macOS, systemd on Linux) so the daemon keeps running and starts on login, prompting you to authenticate through GitHub or your organization's SSO if you haven't already. Choose the method that fits your platform.

macOS (Homebrew)

brew install wandb/taps/wandb-hivemind
hivemind start

Homebrew 6 requires third-party taps to be trusted before their code runs. Installing by fully-qualified name records that trust automatically (you'll see Trusted cask wandb/taps/wandb-hivemind on first install); review or revoke it later with brew trust / brew untrust.

The cask installs a self-updating binary, so there's nothing to upgrade by hand — brew upgrade is a no-op for it unless you pass --greedy. On an Intel Mac, install the Python formula instead: brew install wandb/taps/hivemind (always fully-qualified — homebrew-core has an unrelated package also named hivemind).

macOS or Linux (uv)

uv tool install wandb-hivemind
hivemind start

uv automatically selects the correct binary for your operating system. Upgrade with:

uv tool upgrade wandb-hivemind

Standalone installer (macOS or Linux)

If you'd rather not depend on Homebrew, Python, or uv, the standalone installer downloads a signed binary to ~/.local/bin. It doesn't require sudo:

curl -fsSL https://hivemind.wandb.tools/install | sh
hivemind start

Once started, the standalone binary detects and applies upgrades automatically.

On macOS, the standalone binary requires Apple Silicon; on an Intel Mac, use Homebrew instead. For fleet rollouts through an MDM, see Deploying with MDM.

Docker (sidecar)

For containerized agents, run the daemon as a sidecar that watches the agent's transcript directory. Images are published for linux/amd64 and linux/arm64:

docker run -d \
  -v claude-sessions:/watch/.claude:ro \
  -e HIVEMIND_TOKEN=<your-token> \
  -e HIVEMIND_WATCH_PATHS=/watch/.claude \
  ghcr.io/wandb/hivemind:latest

Mount the directory your agent writes transcripts to (read-only is fine) and point HIVEMIND_WATCH_PATHS at it. The HiveMind server image is also available as ghcr.io/wandb/hivemind-server.

How it works

Once the daemon is running, open any supported coding agent and start working. Within 30 seconds your session appears on the dashboard. You can watch sessions in real-time, review past conversations, and dig into individual tool calls.

Supported agents

Agent Transcript source
Claude Code ~/.claude/projects/ JSONL files
Codex ~/.codex/ session logs
Cursor SQLite databases in Cursor's app data
Gemini CLI ~/.gemini/ session history
OpenCode ~/.opencode/ session files
GitHub Copilot CLI ~/.copilot/session-state/ event logs
Pi ~/.pi/agent/sessions/ JSONL files

The HiveMind agent

HiveMind also installs an @hivemind agent definition when the daemon starts (Claude Code, Codex, and Cursor). Type @hivemind in a supported agent to ask questions about past coding sessions: what you worked on last week, how a bug was fixed, where a particular change was made. It searches across your team's session history and pulls the answer into your current conversation.

How HiveMind compares

HiveMind gives you one view across every coding agent your team uses, instead of a separate dashboard per vendor. Native dashboards from individual agent vendors only show their own usage. HiveMind brings Claude Code, Codex, Cursor, Gemini, Copilot, and more together with session-level detail, spend, and outcomes in one place.

HiveMind and Weave

If you already use W&B Weave, it works together with HiveMind. They cover different stages and answer different questions.

  • Weave observes what your AI application does in production, tracking LLM and agent traces, evaluations, and quality.
  • HiveMind observes how your team builds software with AI coding agents, tracking details like sessions, spend, and productivity.

Next steps

About

Visibility for AI coding agents. Capture your agentic coding sessions so you can search, replay, and learn from them with your teammates.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages