HIVE

Virtual team framework for Claude Code. Create and manage AI-powered dev personas with specialized skills, scopes, and personalities.

Installation

# Via npm (recommended)
npm install -D claude-hive

# Or pnpm/yarn
pnpm add -D claude-hive
yarn add -D claude-hive

# Via GitHub (latest dev)
pnpm add -D github:flavienrako/hive

Update

# Update to latest version
npm update claude-hive

# Check current version
npx hive doctor

Quick Start

# Initialize HIVE in your project
npx hive init --name "MyProject" --devs "alice,bob,charlie"

# Check if ready to work
npx hive doctor

# Launch the dashboard
npx hive ui

Features

• Virtual Devs - AI personas with defined skills, scope, and personality
• Dashboard - Web UI for task management and team overview
• RAG Integration - Semantic search across your codebase
• Token Optimization - Built-in strategies to reduce context usage
• Qwen Helper - Local LLM for commits and summaries

Usage

Health Check

hive doctor          # Check if HIVE is ready to work

Verifies: Ollama, Qwen model, RAG index, HIVE config, dashboard port.

Dashboard

hive ui              # Launch dashboard on http://localhost:3333
hive ui --port 4000  # Custom port
hive ui --dev        # Dev mode with hot reload

Initialize a Project

hive init --name "MyProject" --devs "alice,bob,charlie"

Options:

• --name <name> - Project name (default: folder name)
• --devs <list> - Dev names, comma-separated
• --minimal - Core skills only
• --force - Overwrite existing files
• --keep-claude - Don't replace existing CLAUDE.md

Qwen Helper (Local LLM)

# Generate commit message
git diff --staged | hive qwen commit

# Summarize a file
cat src/index.ts | hive qwen summarize

Project Structure

After init, HIVE creates:

.hive/
  config.json           # Team configuration
  memory.md             # Runtime state (~80 lines)
  devs/
    alice.md            # Dev profile
    bob.md
    charlie.md

.claude/
  commands/             # Slash commands (/dev, /commit, etc.)

CLAUDE.md               # Project instructions for Claude

Commands (in Claude Code)

| Command | Description | |---------|-------------| | /dev <name> | Invoke a virtual dev | | /status | Team status overview | | /commit | Auto-generated commit message | | /learn <insight> | Capture a learning | | /decision <topic> | Document a technical decision | | /assign <dev> <task> | Assign a task |

Prerequisites

• Node.js >= 18
• Ollama + qwen2.5-coder:7b (for /commit and qwen helper)
• Claude Code (for slash commands)

# Install Ollama and model
brew install ollama  # or see https://ollama.ai
ollama serve &
ollama pull qwen2.5-coder:7b

License

MIT