Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (hive-mind-agent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Hive-Mind Agent

Model-agnostic, project-agnostic, platform-agnostic multi-agent orchestration. A central brain + subagent hive that works in Cursor, CLI, MCP, or API. Open source (MIT).

How It Works

Central brain — Sets strategy, assigns tasks, ingests outcomes, updates shared context
Workers — Subagents (via mcp_task in Cursor, or local/HTTP adapters) execute tasks
Shared state — context.md + outcomes/ (paths configurable via hive.config.json)

Quick Start

Install

# Run without installing (npx)
npx hive-mind-agent init

# Or clone and use locally
git clone https://github.com/hive-mind-agent/hive-mind-agent.git
cd hive-mind-agent && npm install

Bootstrap a New Hive

cd your-project
npx hive-mind-agent init
# Edit hive.config.json and context.md

Cursor

Open your project (with hive.config.json or context.md)
Add the hive-mind-central-brain rule (copy from this repo) or hive-mind-orchestrator Skill
Say: "Advance the hive" or "Unleash the hive"

CLI

hive init      # Bootstrap (or: npx hive-mind-agent init)
hive advance   # Inspect context

MCP Server

Add to Cursor MCP config (see docs/mcp-server.md):

{
  "mcpServers": {
    "hive-mind": {
      "command": "node",
      "args": ["/path/to/hive-mind-agent/mcp-server/index.mjs"],
      "env": { "HIVE_ROOT": "/path/to/your-hive" }
    }
  }
}

API Server

HIVE_ROOT=/path/to/hive node api-server.mjs
# Or: npm run api
# Endpoints: GET/PUT /api/hive/context, GET /api/hive/config, POST /api/hive/cycle

Structure

hive-mind-agent/
├── hive.config.json       # Config (targets, adapters, paths)
├── context.md             # Shared state
├── outcomes/              # Worker outputs
├── core/                  # Adapters (context, outcome, LLM)
├── cli.mjs                # CLI
├── mcp-server/            # MCP tools
├── api-server.mjs         # HTTP API
├── docs/
└── .cursor/rules/         # Central brain rule

Docs

Config — hive.config.json, adapters
MCP Server — Cursor MCP setup
API Server — HTTP API
Worker Contract — Task/outcome format
Graduation Path — Standalone scaling

Contributing

See CONTRIBUTING.md. Contributions welcome.

License

MIT — see LICENSE.