-
Notifications
You must be signed in to change notification settings - Fork 53
One-pager for HiveMind #2730
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
mdlinville
wants to merge
34
commits into
main
Choose a base branch
from
DOCS-2709
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
One-pager for HiveMind #2730
Changes from 23 commits
Commits
Show all changes
34 commits
Select commit
Hold shift + click to select a range
88f397f
One-pager for HiveMind
mdlinville 6988258
Merge branch 'main' into DOCS-2709
mdlinville a61272e
One-pager copyedits
mdlinville 12c9e8b
Merge branch 'main' into DOCS-2709
mdlinville 5a8c792
Add usage screenshot
mdlinville cf58902
Merge remote-tracking branch 'origin/DOCS-2709' into DOCS-2709
mdlinville 254ce54
Optimised images with calibre/image-actions
wandb-docs-pr-writer[bot] 5d6523d
Add leaderboard screenshot
mdlinville af4f4fa
Merge remote-tracking branch 'origin/DOCS-2709' into DOCS-2709
mdlinville 83fd3d6
Optimised images with calibre/image-actions
wandb-docs-pr-writer[bot] 2d9ed17
Optimised images with calibre/image-actions
wandb-docs-pr-writer[bot] 927e320
Fix nav
mdlinville bdf7fb9
Fix validity errors
mdlinville 4571040
Merge remote-tracking branch 'origin/DOCS-2709' into DOCS-2709
mdlinville ff18fda
Merge remote-tracking branch 'origin/main' into DOCS-2709
mdlinville 29b4e00
Add session insights screenshot
mdlinville 54603a4
Optimised images with calibre/image-actions
wandb-docs-pr-writer[bot] 4cd76e1
Replace session insights image
mdlinville 9f0ded4
Merge remote-tracking branch 'origin/DOCS-2709' into DOCS-2709
mdlinville 050b057
Merge remote-tracking branch 'origin/main' into DOCS-2709
mdlinville 71e3b77
Optimised images with calibre/image-actions
wandb-docs-pr-writer[bot] 6402dec
Add upgrade details, tweak install contents
mdlinville f0228c1
Merge remote-tracking branch 'origin/DOCS-2709' into DOCS-2709
mdlinville d338861
Apply suggestion from @mdlinville
mdlinville c6c8d9a
Merge branch 'main' into DOCS-2709
mdlinville 071d37a
Merge remote-tracking branch 'origin/main' into DOCS-2709
mdlinville 7fd79dc
docs(hivemind): sync one-pager with upstream P0/P1 changes
mdlinville 9e9c5d4
style(hivemind): apply Google Developer Style Guide to one-pager
mdlinville b7c8a01
Merge remote-tracking branch 'origin/DOCS-2709' into DOCS-2709
mdlinville 1a1b184
Merge branch 'main' into DOCS-2709
mdlinville 27173e9
Merge branch 'main' into DOCS-2709
mdlinville 8bdea6c
Merge branch 'main' into DOCS-2709
mdlinville bd4169c
Merge branch 'main' into DOCS-2709
mdlinville d9faf95
Apply suggestions from code review
mdlinville File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Submodule .claude
updated
from 1895e3 to 336343
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,100 @@ | ||
| --- | ||
| title: "W&B HiveMind" | ||
| description: "A shared dashboard to track your organization's AI coding-agent activity and spend across Claude Code, Cursor, Codex, Gemini, and more in a shared dashboard with leaderboards, team views, efficiency insights, search, and more." | ||
| sidebarTitle: "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 a central service. The HiveMind dashboard shows what your team is doing with agents, what that work costs, and what it produces. The dashboard provides leaderboards, team views, efficiency insights, search, and more. Learn from your organization's prior AI usage by importing existing sessions from local tools like Claude Code or Cursor. | ||
|
|
||
| HiveMind is designed for a dual audience: | ||
|
|
||
| - **Developers and AI practitioners** can review past sessions, search their team's history, and improve how they work with coding agents. | ||
| - **Engineering leaders** can track AI coding adoption, spend, and outcomes across teams and repositories. | ||
|
|
||
|
|
||
| HiveMind and its documentation live on a dedicated site: [hivemind.wandb.tools](https://hivemind.wandb.tools). | ||
|
|
||
| ## Capabilities | ||
|
|
||
| - **See sessions across agents.** One daemon captures sessions from every supported agent, with no per-agent configuration. | ||
| - **Track spend and usage.** View estimated cost over time, cost by model and team, token usage, and cost per merged pull request. Cost figures are estimates from published model pricing and session token counts, not billed amounts from your AI vendors. | ||
| - **Measure outcomes.** Connect agent activity to pull requests, merge rates, and how much agent-written code survives. | ||
| - **Reuse past work.** Search your team's session history and bring relevant context into your current coding agent. | ||
|
|
||
| These screenshots show example pages in the HiveMind dashboard: a usage report, a leaderboard, and the detailed view of a session. Click a screenshot to view details. | ||
|
|
||
| <Columns cols={2}> | ||
| <Frame></Frame> | ||
|
mdlinville marked this conversation as resolved.
Outdated
|
||
| <Frame></Frame> | ||
| </Columns> | ||
| <Columns cols={1}> | ||
| <Frame></Frame> | ||
| </Columns> | ||
|
|
||
| ## Supported agents | ||
|
|
||
| HiveMind captures sessions from many coding agents, with no agent-specific configuration required. For example: | ||
|
|
||
| - Claude Code | ||
| - Codex | ||
| - Cursor | ||
| - Gemini CLI | ||
| - OpenCode | ||
| - GitHub Copilot CLI | ||
| - Pi | ||
|
|
||
| For the full list, see [hivemind.wandb.tools](https://hivemind.wandb.tools). | ||
|
|
||
| ## Quickstart | ||
|
|
||
| Install the client, authenticate, and start the daemon. Choose the method that fits your platform. | ||
|
|
||
| <Tabs> | ||
| <Tab title="HomeBrew (macOS)"> | ||
| Install with HomeBrew on macOS: | ||
|
|
||
| ```bash | ||
| brew install wandb/taps/hivemind | ||
| hivemind login | ||
| hivemind start | ||
| ``` | ||
|
|
||
| - When you run `hivemind start`, it registers a background service (launchd on macOS, systemd on Linux) so the daemon keeps running and starts on login. | ||
| - Upgrade using `brew update; brew install wandb/taps/hivemind`. | ||
|
|
||
| </Tab> | ||
| <Tab title="uv (macOS or Linux)"> | ||
| Install with `uv` on macOS or Linux: | ||
|
|
||
| ```bash | ||
| uv tool install wandb-hivemind | ||
| hivemind login | ||
| hivemind start | ||
| ``` | ||
|
|
||
| - `uv` automatically selects the correct binary for the operating system. | ||
| - When you run `hivemind start`, it registers a background service (launchd on macOS, systemd on Linux) so the daemon keeps running and starts on login. | ||
| - Upgrade using `uv tool upgrade wandb-hivemind`. | ||
| </Tab> | ||
| <Tab title="Standalone binary (macOS or Linux)"> | ||
|
|
||
| Download and install HiveMind using the signed standalone binary: | ||
|
|
||
| ```bash | ||
| curl -fsSL https://hivemind.wandb.tools/install | sh | ||
| hivemind login | ||
|
mdlinville marked this conversation as resolved.
Outdated
|
||
| ``` | ||
|
|
||
| - Privileged access (`sudo`) is not required. | ||
| - The installer registers a background service (launchd on macOS, systemd on Linux) so the daemon keeps running and starts on login. | ||
| - The binary detects and applies upgrades automatically. | ||
|
|
||
| <Tip>For details about distributing and installing the standalone binary with fleet rollout tools like JAMF, Intune, Mosyle, Kandji, or Workspace ONE, see [MDM](https://hivemind.wandb.tools/docs/mdm) in the HiveMind documentation.</Tip> | ||
| </Tab> | ||
|
|
||
| </Tabs> | ||
|
|
||
| With the daemon running, your session appears on the dashboard within around 30 seconds of using a supported agent. | ||
|
|
||
| ## Next steps | ||
| See [HiveMind documentation](https://hivemind.wandb.tools/docs/overview) for full details about setup, permissions, the CLI reference, troubleshooting, and more. | ||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. FYI we are probably going to move these charts to a new org settings page.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ack |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.