Open-source · MCP service · Apache-2.0

The open memory layer for collective agent awareness.

Agents don't just share memory. They notice what others are doing, inherit what others have learned, and understand complex projects together.

Read the docs Star on GitHub
$ npx @lesur-ai/hivemind init · hivemind on :8080
The problem

LLMs are isolated by design.

Every agent starts from zero. Context is lost between sessions, work is duplicated across a team, and the rules one agent discovered never reach the next. Coordination becomes a copy-paste of prompts.

Hivemind gives a team of agents one shared, append-only memory space — so they coordinate from the same context instead of re-discovering it.

Collective agent awareness

Three moments where isolated agents start to coordinate.

NOTICE

It sees what's already in motion.

An agent changes its behaviour because it's aware of another agent's current work — proposing a better-coordinated approach instead of colliding.

INHERIT

It picks up the handoff, unprompted.

An agent recovers a rule, method, or active project context left by another in the consolidated bank. The handoff lives in the memory layer, not a manual prompt.

UNDERSTAND

It rediscovers meaning across the project.

An agent explores project concepts through an ontology-backed knowledge graph — entities, typed relations, and conceptual links populated by the collective process.

Three memory horizons

One mark. Three layers of memory.

The lattice H maps the system: live work signals on top, the consolidated bank at the consolidating centre, the ontology knowledge graph rooted at the base.

short· live notes · append-only · ~50 ms

Immediate working context

Observations, decisions, todos — what each agent is doing right now, written fast and visible across the whole space.

mid· the bank · LLM-consolidated · ~15 s

Consolidated memory bank

An LLM folds raw notes into structured Markdown — rules, project context, guidelines. The working memory other agents inherit from.

long· ontology · knowledge graph

Ontology-backed knowledge graph

Ontology-guided extraction turns the bank into entities and typed relations: a conceptual map, not a search box. Protocol-derived, never the commit or audit source.

depends_on supersedes WebhookRetry IdempotencyKey adr/014 adr/009
How it works

An open protocol, not a black box.

Raw notes refine into a consolidated bank, then into the long-term ontology graph: one continuous pipeline that distils information across short, mid and long. Across a team, sovereign instances keep the same space in sync, with no central server.

The consolidation pipeline
live

Write

Agents append timestamped notes — no friction, no conflicts, cross-visible to the team.

bank

Consolidate

An LLM rewrites notes into structured Markdown against the space's rules — read in one call at startup.

longprotocol-derived

Capitalize

Stable documents feed ontology-guided extraction into named entities and typed relations, a conceptual map in the knowledge graph.

Sovereign by design

Full-mesh per space. No central instance.

one shared space · payments-revamp
acme bank v23 lab-b bank v23 edge bank v23

Every peer holds its own copy of the same space — same bank version, kept in step by signed sync events along each link. Each team keeps its own infrastructure, backups, and LLM credentials. No hub, no single point of failure.

Protocol guarantees
Single-writer, atomic commits
A durable queue, token lease, term and fencing serialize every shared mutation — no concurrent writes to the bank.
Durable provenance
Replicated notes carry origin node, agent, and event id. Tombstones and watermarks prevent resurrection after consolidation.
Fail-closed, never silent
All-ACK over quorum. A corrupt critical record blocks the space until explicit restore or recovery — a visible block beats a double write.
S3 is the source of truth
All protocol state lives on object storage — no external database. The knowledge graph is a protocol-derived tier — powerful, but never the commit or audit source.
Watch the memory live

A real-time window into the shared space.

localhost:8080/live — payments-revamp
Space
payments-revamp
healthy · 3 peers
47
live notes
9
bank files
Agents
claude-code21
cline-vsc18
codex-cli8
Live timeline · today
decision
claude-code — switching the webhook retry to idempotency keys, see adr/014.
observation
cline-vsc — noticed the refactor on auth/, holding off to avoid a clash. ack ✓
progress
codex-cli — migration 0042 applied on staging, tests green.
activeContext.md progress.md decisions.md
## Current focus

Hardening the payment webhook path. Retry logic now keyed on idempotency tokens; auth refactor in flight under claude-code.

Consolidated from 12 notes · 4 min ago · bank v23

The MCP surface

45 tools. One protocol. Any agent.

Spoken over MCP. Works with Claude, Cline, Codex, anything that speaks MCP.

System3

health · whoami · about

Space9

create · rules · summary · export

Live3

note · read · search

Bank11

read_all · consolidate · compact

Long6

connect · ingest · query · push · status

Backup5

create · restore · download

Admin8

tokens · scope · GC · purge

7 categories
read · write · admin scopes
Self-hostable

A minimal stack: S3 + an OpenAI-compatible LLM. No vendor lock-in, no local database.

Locked down

SHA-256 bearer tokens, read/write/admin scopes, and a Caddy + Coraza OWASP WAF in front.

Auditable

Every protocol event is journaled on S3. Provenance, ACKs, and commits are inspectable, not magic.

Open source

Apache-2.0, versioned protocol, and a documented contribution workflow driven entirely through GitHub.

Give your agents a memory they share — and an awareness they don't have alone.

Get started on GitHub View on GitHub