Whole Brain

The HivemindOS whole brain is the shared memory, retrieval, skill, and coordination system for the fleet.

It is not one magic database. The real anchor is a normal Obsidian markdown vault. Everything else either reads it, writes to it, indexes it, repairs it, or helps agents use it without making a mess.

Short version:

The vault is the durable shared brain. Brain services can index, compile, visualize, or repair it. They do not replace it.

Component Pages

Vault Map

The canonical folders, what belongs where, and which paths are operational state.

Open vault map

Brain Services

GBrain, Syntho, Trading Brain, the Brain Graph, the context index, and service notes.

Open services

Shared Skills

The shared skill shelf, provider mirrors, auto sync policy, and test cleanup rules.

Open shared skills

Shared Env

Where agent secrets live, how hive env helpers work, and why plaintext keys stay out of the vault.

Open shared env

Sync And Health

Hivemind Sync, vault doctor, conflict cleanup, secure backups, and migration manifests.

Open sync docs

Architecture Sync

The rule that keeps setup, vault structure, agent instructions, tests, and docs aligned.

Open sync rules

Code Map

The source files and API route families that own brain behavior.

Open code map

Mental Model

flowchart TD
  User["User and agents"] --> Dashboard["HivemindOS dashboard"]
  Dashboard --> Vault["Shared Obsidian vault"]
  Dashboard --> ContextIndex["Context index"]
  Dashboard --> BrainGraph["Brain graph"]
  Dashboard --> Skills["Shared skills"]
  Vault --> SyncOwner["Hivemind Sync"]
  SyncOwner --> VaultOwner["External sync / HivemindOS Syncthing / manual repair"]
  SyncOwner --> Transfers[".hivemindos-transfers handoffs"]
  Vault --> GBrain["GBrain retrieval"]
  Vault --> Syntho["Syntho reviewed synthesis"]
  Vault --> Operations["Operations state"]
  Skills --> RuntimeProviders["Codex / Claude / Hermes / Gemini / OpenClaw / Aeon"]
  Operations --> Doctor["Vault doctor and migration manifests"]

Source Of Truth

The durable source of truth is the configured vault, usually:

~/Documents/Obsidian/hivemindos-vault

Fresh installs seed this structure through the setup scripts and foundation seeder. Existing installs can run:

pnpm vault:doctor
pnpm vault:doctor -- --fix

The doctor is read only unless --fix is passed. Fixes move content into canonical folders or archive stale artifacts under Operations/Vault Migrations/.