Skip to content

Add W&B HiveMind product documentation#2713

Draft
vanpelt wants to merge 4 commits into
mainfrom
docs-hivemind-launch
Draft

Add W&B HiveMind product documentation#2713
vanpelt wants to merge 4 commits into
mainfrom
docs-hivemind-launch

Conversation

@vanpelt

@vanpelt vanpelt commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Ports the W&B HiveMind docs (a shared dashboard for AI coding sessions) into the Mintlify site, following the same product structure as Weave. Sourced from the existing MDX docs in the agentstream-py dashboard.

Branded as W&B HiveMind in the Weights & Biases product group, treated as generally available (no preview tag).

What's included

File Purpose
hivemind.mdx Landing page (mode: wide) with install tabs, a CardGroup of doc links, supported-agents table, and the @hivemind agent section
hivemind/features.mdx Dashboard tour + GitHub/Slack integrations
hivemind/permissions.mdx Visibility, workspaces, SSO, auth, scopes
hivemind/cli.mdx Full hivemind command reference
hivemind/bots.mdx Service accounts, OIDC federation, CI patterns
hivemind/mdm.mdx Fleet rollout via JAMF/MDM
product-hivemind.mdx Product dropdown redirect stub
icons/HiveMind.svg Honeycomb glyph for the home-page product card

Plus: a ProductCard on the home page (index.mdx, Weights & Biases group widened to 3 columns), navigation registration in docs.json (en tab), and an AGENTS.md directory note.

Standards applied to match the site

  • Frontmatter title/description; H1 folded into frontmatter (no leading #)
  • GitHub > [!NOTE/IMPORTANT/WARNING/TIP] callouts converted to Mintlify <Note>/<Warning>/<Tip>
  • Internal links rewritten /docs/.../hivemind/...; relative /admin/... links made absolute to hivemind.wandb.tools
  • Sentence-case headings, straight quotes, em-dashes replaced per the style guide

Validation

  • mint dev: all routes return 200; landing page, home-page card, and content pages render correctly (callouts, tables, code blocks, TOC)
  • mint broken-links: no broken links found

Notes for reviewers

  • Localization: registered in the en tab only. The fr/ja/ko tabs are untouched and independent, so nothing breaks; the gt tooling can generate translations later.
  • External references (GitHub App, Slack app, homebrew-taps releases) are carried over verbatim from the source docs — worth a sanity check that those public URLs are live before launch.

🤖 Generated with Claude Code

Port the HiveMind docs (a shared dashboard for AI coding sessions) into the
Mintlify site, following the same product structure as Weave:

- hivemind.mdx: product landing page with install tabs, doc cards, and the
  supported-agents table
- hivemind/{features,permissions,cli,bots,mdm}.mdx: ported from the HiveMind
  source docs, with GitHub callouts converted to Mintlify components and
  internal links rewritten to /hivemind/*
- product-hivemind.mdx: product dropdown redirect stub
- icons/HiveMind.svg: honeycomb glyph for the home-page product card
- index.mdx: add a W&B HiveMind ProductCard to the Weights & Biases group
- docs.json: register the W&B HiveMind menu item and dropdown entry (en)
- AGENTS.md: note the new /hivemind/ directory

Validated with mint dev and mint broken-links (no broken links).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Jun 2, 2026, 9:19 PM

@github-actions

github-actions Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (8 total)

📄 Pages (7)

File Preview
hivemind.mdx Hivemind
hivemind/bots.mdx Bots
hivemind/cli.mdx Cli
hivemind/features.mdx Features
hivemind/mdm.mdx Mdm
hivemind/permissions.mdx Permissions
product-hivemind.mdx Product Hivemind

🖼️ Images (1)

File Preview
icons/HiveMind.svg View HiveMind

📝 Changed (3 total)

📄 Pages (1)

File Preview
index.mdx .
⚙️ Other (2)
File
AGENTS.md
docs.json

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 4be9798 at 2026-06-02 21:38:14 UTC

@github-actions

github-actions Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-docs-hivemind-launch.mintlify.app

@w-b-hivemind

w-b-hivemind Bot commented Jun 2, 2026

Copy link
Copy Markdown

HiveMind Sessions

1 session · 31m · $13

Session Agent Duration Tokens Cost Lines
Untitled
53b29f68-9750-4bdf-adfd-b2e469be56fb
claude 31m 88.3K $13 +1183 -46
Total 31m 88.3K $13 +1183 -46
Screenshots

View all sessions in HiveMind →

Run claude --resume 53b29f68-9750-4bdf-adfd-b2e469be56fb to pickup where you left off.

vanpelt and others added 2 commits June 2, 2026 17:30
…mands

hivemind start now sets up the platform service manager itself, so users
don't run brew services or install-service directly.

- Linux quickstart: drop hivemind install-service (start does it)
- CLI quickstart: hivemind start instead of brew services start
- Troubleshooting: hivemind restart instead of brew services restart

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Mintlify already renders next/prev page links, so the manual cross-link
lists at the end of mdm and bots are redundant.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant