hivemind

Name: hivemind
Author: hiveforge-sh

Local

github.com/hiveforge-shMemory & Knowledge10Updated 4d ago

Repository

About hivemind

hivemind is a local-first Obsidian plugin for worldbuilders, researchers, and teams. It structures vault notes for AI queries and adds visualizations and an approval workflow to keep established content consistent.

Key features

01Structured access to Obsidian notes
02Timeline and relationship graph views
03Draft, pending, and canon workflow
04Templates for worldbuilding and research
05Custom entity types
06Data stays on the local machine

Use cases

01Track characters, places, and events in fiction
02Query research notes and explore concept links
03Record team goals and meeting context
04Organize systems, components, and architecture decisions

MCP support

It provides an MCP-compatible server so AI tools such as Claude and GitHub Copilot can query an Obsidian vault.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "hiveforge-sh-hivemind": {
      "command": "npx",
      "args": [
        "-y",
        "@hiveforge/hivemind-mcp"
      ],
      "env": {
        "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
        "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
      }
    }
  }
}

Run commandnpx -y @hiveforge/hivemind-mcp

Environment variables to set

HIVEMIND_VAULT_PATHPath to your Obsidian vault directory

HIVEMIND_CONFIG_PATHPath to optional Hivemind config file

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@hiveforge/hivemind-mcp3.6.3stdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Hivemind for Obsidian

Your canon is the source of truth. AI stays inside the lines.

Why Hivemind?

When building fictional worlds — whether you're writing a novel, designing a game, or running an RPG campaign — AI tools can be powerful collaborators. But they hallucinate. Ask your AI assistant about a character you created last week, and it might invent details that contradict your established canon.

Hivemind solves this by giving AI tools structured access to your Obsidian vault. Think of it as an AI Firewall: your worldbuilding notes become a truth anchor that keeps AI grounded in facts you control. Ask about a character, and the AI reads your actual notes — not a hallucinated version. Query a timeline, and it references your established events — not invented dates.

Beyond AI integration, Hivemind provides powerful visualization tools:

Timeline View — See your story's events laid out chronologically
Graph View — Explore relationships between characters, locations, factions, and more
Canon Workflow — Track which content is approved, in review, or still draft

Hivemind is built for worldbuilders, but the same principles apply to research vaults, people management, software architecture — anywhere you need AI to respect your established knowledge.

Features

Timeline View — Visualize events chronologically with filtering and search
Graph View — Explore entity relationships with interactive visualization
AI Integration — MCP-compatible server for Claude, GitHub Copilot, and other AI tools
Pluggable Templates — Built-in templates for worldbuilding, research, people management, and more
Canon Workflow — Draft → Pending → Canon approval system with consistency validation
Obsidian Native — Works with standard markdown, YAML frontmatter, and wikilinks
Local-First — Your data stays on your machine

Built-in Templates

Template	Use Case	Entity Types
Worldbuilding	Fiction writers, game designers, RPG creators	Characters, Locations, Events, Factions, Lore, Assets
Research	Academics, knowledge workers	Papers, Citations, Concepts, Notes
People Management	Managers, team leads	People, Goals, Teams, 1:1 Meetings
Software Architecture	Engineers, architects	Systems, Components, ADRs, Constraints

Define your own custom entity types via config — no code required. See CONTRIBUTING_TEMPLATES.md for details.

Installation

Obsidian Plugin (Recommended)

Open Obsidian Settings
Go to Community plugins → Browse
Search for "Hivemind"
Click Install, then Enable

Manual Installation

Download the latest release from GitHub Releases
Extract to your vault's .obsidian/plugins/hivemind directory
Reload Obsidian and enable the plugin in Settings

AI Integration (Optional)

Want AI tools to query your vault? Set up the MCP server:

MCP Setup Guide →

The guide covers:

Claude Desktop configuration (Windows, macOS, Linux)
GitHub Copilot configuration
Template selection
Troubleshooting

Quick Start

Choose a template — Open Hivemind settings in Obsidian and select a template (worldbuilding, research, etc.)
Create entities — Use Obsidian's note creation as usual. Add YAML frontmatter to define entity types:
```
---
entity_type: character
canon_status: draft
---
```
Visualize — Open the Timeline view or Graph view from the ribbon icons
Connect to AI — Follow the MCP Setup Guide to let AI tools query your vault

For detailed setup instructions, see docs/SETUP_GUIDE.md.

Screenshots

Timeline View

Coming soon — chronological visualization of events

Timeline View Placeholder

Graph View

Coming soon — interactive entity relationship visualization

Graph View Placeholder

Use Cases

Worldbuilding:

Track characters, locations, and events across your novel
AI remembers your character details when helping with dialogue
Visualize timeline of your story's key events

Research:

Organize papers, citations, and concepts in your field
AI references your actual research when answering questions
Explore connections between concepts in your knowledge base

People Management:

Track team goals, 1:1 meeting notes, and people details
AI recalls context from previous meetings when drafting agendas
Visualize team relationships and reporting structures

Software Architecture:

Document systems, components, and architectural decisions (ADRs)
AI references your ADRs when suggesting design patterns
Track dependencies between components visually

Documentation

Setup Guide — Getting started with Hivemind
MCP Setup Guide — AI integration configuration
Vault Migration Guide — Migrating existing vaults
Canon Workflow — Using canon workflow beyond worldbuilding
Contributing Templates — Create and share templates
Sample Vaults — Example vaults for each template

Community

Issues & Feature Requests — GitHub Issues
Discussions — GitHub Discussions

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Important: This project uses Conventional Commits. Commit messages must follow the format:

<type>: <description>

[optional body]

Common types: feat, fix, docs, style, refactor, test, chore

License

MIT — Free for personal and commercial use.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.