hive-mind

hive-mind -- Local-First AI Memory System

Persistent memory, semantic search, knowledge graph, and wiki compiler for AI agents. Runs locally. Zero cloud dependency.

📊 Benchmark: Self-judge 73.1% (Opus 4.7) / 73.4% (Qwen3.6-35B) on LoCoMo N=320 stratified, +4.6pp over Mem0 paper baseline. Trio-strict ensemble (Opus 4.7 + GPT-5.5 + MiniMax M2.7): 67.8%; self-judge inflation +5.3pp. Substrate-claim memory-lift: Fisher one-sided p = 8.07 × 10⁻¹⁸ at N=400 (retrieval 22.25% vs no-context 3.00%).

---

Features

• 21 MCP tools -- plug into Claude Code, Codex, Hermes, or any MCP-compatible client
• 10 harvest adapters -- ingest from ChatGPT, Claude, Claude Code, Gemini, Perplexity, PDF, Markdown, plain text, URL, and universal formats
• FTS5 + vector hybrid search -- full-text and semantic search fused via Reciprocal Rank Fusion
• Knowledge graph -- entities, relations, and bitemporal validity tracking
• I/P/B memory frames -- intra-frame (facts), predicted-frame (hypotheses), bidirectional-frame (corrections) with automatic compaction
• Wiki compiler -- synthesize memory frames into interlinked wiki pages using any LLM
• Identity and awareness layers -- persistent user identity and active task/state tracking
• Session management -- group memories by conversation with GOP (Group of Pictures) organization
• Multiple embedding providers -- API, in-process, Ollama, LiteLLM
• SQLite-backed -- single-file database, zero infrastructure, instant backups
• Workspace isolation -- separate memory spaces per project

Quick Start

With Claude Code — one-line plugin install (recommended)

The fastest path: install hive-mind as a Claude Code plugin. You get the MCP server (21 tools) PLUS in-loop memory via 5 lifecycle hooks (SessionStart, UserPromptSubmit, Stop, PreCompact, PostToolUse) PLUS the /hive <query> slash command. Cross-platform — no PowerShell vs bash split.

/plugin marketplace add marolinik/hive-mind
/plugin install hive-mind@hive-mind

What you get:

• 5 hooks active (in-loop memory + synth queue + decision archaeology + contradiction detection)
• @hive-mind/mcp-server auto-registered (21 tools)
• /hive <query> slash command for ad-hoc wiki search

With Claude Code — MCP-only (manual)

If you only want the MCP server (no in-loop hooks), add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "hive-mind": {
      "command": "npx",
      "args": ["@hive-mind/mcp-server"]
    }
  }
}

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hive-mind": {
      "command": "npx",
      "args": ["@hive-mind/mcp-server"]
    }
  }
}

With Codex

{
  "mcpServers": {
    "hive-mind": {
      "command": "npx",
      "args": ["@hive-mind/mcp-server"]
    }
  }
}

With Hermes or any MCP client

npx @hive-mind/mcp-server

The server communicates via stdio, compatible with any MCP client implementation.

As a library

npm install @hive-mind/core

import { MindDB, FrameStore, HybridSearch, KnowledgeGraph } from '@hive-mind/core';