Skip to content

Commit 51656d5

Browse files
rithulkameshrithulkamesh
committed
feat(docs): restructure site with new landing page and sidebar navigation
- Animated landing page with hero, feature grid, code tabs, and registry callout - New sidebar hierarchy: Getting Started, Core Concepts, Plugins, CLI, Registry, Self-hosting - Geist + JetBrains Mono fonts, amber color system, dark-only mode - Create stub docs for all new sidebar entries - Remove unused dependencies
1 parent 3e3f34d commit 51656d5

42 files changed

Lines changed: 1849 additions & 1001 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎website/docs/changelog.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
title: Changelog
3+
description: What's new in each release. Mirrored from the GitHub changelog.
4+
---
5+
6+
# Changelog
7+
8+
This page mirrors the [project changelog on GitHub](https://github.com/rithulkamesh/hivemind/blob/main/CHANGELOG.md). Update it when cutting a new release.
9+
10+
---
11+
12+
## [Unreleased]
13+
14+
---
15+
16+
## [2.1.5] — 2026-03-11
17+
18+
### Added
19+
20+
- **In-app HITL resolution** — Optional in-process resolver so you can approve/reject HITL requests in the same terminal as `hivemind run`.
21+
- **HITL in single-node path** — HITL escalation check and resolver/polling now run in the default single-node flow.
22+
- **Better MCP** — `hivemind doctor` has a dedicated "MCP Servers" section.
23+
- Full CLI visual redesign: amber/blue/teal color system across all commands
24+
- Structured logging with tracing-compatible format
25+
- Live run view: real-time task table, tool activity, cost counter during execution
26+
- Animated planning phase with strategy selection feedback
27+
- Redesigned hivemind init: interactive wizard with welcome screen
28+
- Typed error classes with actionable hints and docs links
29+
- Shell completions: bash, zsh, fish
30+
- `--debug`, `--trace`, `--quiet`, `--no-color`, `--json`, `--plain` global flags
31+
32+
### Changed
33+
34+
- All CLI output uses themed console
35+
- Python logging replaced with HivemindLogger
36+
- Error display: no raw tracebacks shown to end users
37+
- **Planner: simple-task fast path** — Short, single-step prompts no longer get decomposed into 5 steps
38+
- **Planner: dynamic step count** — Planner asks for "the minimal number of smaller steps needed"
39+
40+
---
41+
42+
## [2.1.0] — 2026-03-11
43+
44+
### Added
45+
46+
- **MetaPlanner** — Decompose mega-tasks into sub-swarms with dependencies, SLAs, and priorities
47+
- **Human-in-the-Loop (HITL)** — Configurable escalation triggers and approval workflows
48+
- **ApprovalStore** — Persistent pending approvals with timeout handling
49+
- **CLI** — `hivemind meta` and `hivemind approvals` commands
50+
51+
---
52+
53+
## [2.0.0] — 2026-03-10
54+
55+
### Breaking Changes
56+
57+
- Provider config schema updated
58+
- Agent execution now routed through AgentSandbox by default
59+
- Memory storage now redacts PII by default
60+
61+
### Added
62+
63+
- Abstract LLM router with Ollama, vLLM, and custom OpenAI-compatible endpoint backends
64+
- Provider fallback chains: automatic failover across backends
65+
- Agent sandboxing: resource quotas, tool category restrictions
66+
- Audit logging: append-only JSONL with chain integrity verification
67+
- PII redaction and GDPR/CCPA compliance config section
68+
- Simulation mode: dry-run planning without LLM calls
69+
- `hivemind explain`, `hivemind simulate`, `hivemind audit` CLI commands
70+
71+
---
72+
73+
For older releases, see the [full changelog on GitHub](https://github.com/rithulkamesh/hivemind/blob/main/CHANGELOG.md).

‎website/docs/cli/config.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "CLI: config"
3+
---
4+
5+
# hivemind config
6+
7+
Coming soon.

‎website/docs/cli/memory.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
title: "CLI: memory"
3+
---
4+
5+
# hivemind memory
6+
7+
List and manage memory entries from the default memory store.
8+
9+
## Usage
10+
11+
```bash
12+
hivemind memory [--limit N]
13+
hivemind memory consolidate [--dry-run] [--min-cluster-size 3]
14+
```
15+
16+
## Examples
17+
18+
```bash
19+
hivemind memory
20+
hivemind memory --limit 50
21+
hivemind memory consolidate --dry-run
22+
```
23+
24+
## Behavior
25+
26+
- **List (default):** Lists memory entries from the default memory store.
27+
- **Consolidate:** Clusters similar memories, summarizes clusters, archives originals. Requires `[data]` extra.

‎website/docs/cli/overview.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: CLI Overview
3+
---
4+
5+
# CLI Overview
6+
7+
The Hivemind CLI is invoked as **`hivemind`** (installed with the `hivemind-ai` package). Run `hivemind --help` or `hivemind <command> --help` for usage and examples.
8+
9+
## Commands
10+
11+
| Command | Description |
12+
|---------|-------------|
13+
| `hivemind run` | Run a swarm task |
14+
| `hivemind init` | Initialize a new project |
15+
| `hivemind doctor` | Verify environment and configuration |
16+
| `hivemind tui` | Launch the terminal UI |
17+
| `hivemind workflow` | List, validate, or run workflows |
18+
| `hivemind memory` | List or consolidate memory entries |
19+
| `hivemind credentials` | Manage API keys via OS keychain |
20+
| `hivemind node` | Distributed mode commands |
21+
| `hivemind query` | Query the knowledge graph |
22+
| `hivemind analyze` | Analyze a run or repository |
23+
| `hivemind cache` | Manage the task result cache |
24+
| `hivemind upgrade` | Check for and install updates |
25+
26+
## Global Flags
27+
28+
- `--debug` — Enable debug logging
29+
- `--trace` — Enable trace-level logging
30+
- `--quiet` — Suppress non-essential output
31+
- `--no-color` — Disable colored output
32+
- `--json` — Output as JSON
33+
- `--plain` — Plain text output (no Rich formatting)

‎website/docs/cli/plugins.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "CLI: plugins"
3+
---
4+
5+
# hivemind plugins
6+
7+
Coming soon.

‎website/docs/cli/reg.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "hivemind reg"
3+
---
4+
5+
# hivemind reg
6+
7+
Coming soon.

‎website/docs/cli/registry.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "CLI: registry"
3+
---
4+
5+
# hivemind registry
6+
7+
Coming soon.

‎website/docs/cli/run.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: "CLI: run"
3+
---
4+
5+
# hivemind run
6+
7+
Runs the swarm with the given task. The swarm plans subtasks, runs them with agents (with tools and memory if configured), and prints results.
8+
9+
## Usage
10+
11+
```bash
12+
hivemind run "task description"
13+
```
14+
15+
## Examples
16+
17+
```bash
18+
hivemind run "analyze diffusion models"
19+
hivemind run "Summarize swarm intelligence in one paragraph."
20+
hivemind run --summary # print only run summary
21+
```
22+
23+
## Behavior
24+
25+
- Uses config for `worker_model`, `planner_model`, `events_dir`, and memory/data paths.
26+
- Creates an event log in the configured events directory.
27+
- Prints each task ID and its result.
28+
- Shows a live view by default when running in a TTY (use `--plain` for old behavior).

‎website/docs/cli/tools.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: "hivemind tools"
3+
---
4+
5+
# hivemind tools
6+
7+
Coming soon.

‎website/docs/concepts/agents.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: Agents
3+
---
4+
5+
# Agents
6+
7+
Coming soon.

0 commit comments

Comments
 (0)