Peer to peer shared memory for AI agents

HiveMind lets every agent on every machine remember what the others have learned, automatically, with no central server.

Install in one command ★ Star on GitHub ♥ Sponsor

What you get

⚖

Coordinate without a coordinator

Agents work in concert through the shared hive, not a central boss. No leader, no lock server, no single point of failure. Every device is equal.

Learn more →
◉

Syncs automatically

When one agent learns something, every other agent on every machine gets it too. No manual updates. Works over Tailscale with no extra setup.

Learn more →
✓

Trust earned, not assumed

Facts only gain confidence when multiple independent agents agree on them. A single agent can't inflate its own credibility. Agreement has to be earned.

Learn more →
⚙

Works with your agents today

Drop-in support for Claude Code, Hermes, and Claude Desktop (through a local MCP server). Any agent that can run a shell command can read and write to the hive.

Learn more →
🔑

Admit devices, once

A new device joins read-only (sterile) and reads everything, but its writes are held back until you admit it. Run hv admit once to make it a full read-write (fertile) member; hv whoami shows any device's status.

Learn more →
⚡

Local search

Search runs entirely on your machine: no round trips, no remote service, no data leaving your network.

Learn more →
∅

Nothing to operate

No servers to provision, no databases to manage, no cloud accounts. Install it, run it, forget it. Your laptop is the infrastructure.

Learn more →
🔗

Full history, always

Every fact is recorded with who wrote it and when. Nothing is ever silently overwritten. You can always trace where a belief came from.

Learn more →
✈

Works offline

Agents keep working with no connection. When a device comes back, its entries merge cleanly. No device is ever blocked waiting on another.

Learn more →
📖

Open and auditable

Open source under the AGPL. Read the code, audit how your memory is handled, and fork it. The privacy is verifiable, not just promised.

Learn more →
🗝

An owner key you can recover

Back the owner key up off-device or escrow it inside the hive, hand it to a new key by nomination, and if it is lost outright, let your admitted devices elect a new owner once the old one has gone quiet. A live owner can never be unseated.

Read the docs →
⛓

Tools that wire themselves

Record how to set up a tool or agent once, as a cell in the hive, and every device can wire itself with hv wire. Credentials come from sealed capsules, and by default only the owner may publish definitions.

Read the docs →
🛡

Security you can check

Prove your install is the official release with hv verify, read the threat model and the published advisories, and report problems privately. It all starts from SECURITY.md.

Read the docs →

How it works

Each agent writes to its local memory. HiveMind keeps all your devices in sync so every agent sees the full picture.

Write

Agents store facts, decisions, and observations via a simple CLI. Each write is tagged with who made it.

Sync

Devices compare what they have and exchange only what's missing. Efficient, peer-to-peer, no central broker.

Search

Full-text search across everything your agents have ever learned, ranked by effective confidence: how many independent sources agree, decayed by age.

Your whole hive in a browser

One command opens a live web view of everything your agents have learned and how your devices are doing. The sync daemon serves it, so there is no second service to run and nothing is exposed to the public internet. Open it on any device that runs HiveMind, including an Android phone running it in Termux; other devices' data is fetched for you with a signed request.

$ hv dash # opens your browser; --print just prints the URL
HiveMind dashboard, Overview tab

The Overview tab. Every count is a link to what it counts.

▦

Overview

The size of the hive, contested facts, and the boot audit, with your best facts and latest decisions underneath. Every count links to what it counts.

Open →
⌕

Corpus

Search facts and decisions together. Filter by tag, sort by confidence or recency, and open any record with the facts that relate to it.

Open →
⬡

Hive

Every admitted device with its address and live sync status. Click a node to open its own detail, proxied over the tailnet.

Open →
◷

Telemetry

Each node's session telemetry, pulled together live: sessions, time, tokens, and cost, with per-day and per-model breakdowns to sort, filter, and drill.

Open →

Read-first, and provably genuine

The dashboard observes and never changes the hive; changes are made with the hv CLI, as signed entries from a device you control. The shield in the header reflects your live hv verify result: a green shield for a genuine install, a red one with the steps to re-align for a modified copy. Use only the official HiveMind from ProjectMentor.

Get started in one command

# Install $ curl -fsSL https://raw.githubusercontent.com/projectmentor/hive-mind/main/scripts/installer/install.sh | bash $ hive-mind install

Try it out

# Store something $ hv remember "The payments API rate-limits at 100 req/s" --tags api,payments # Find it later $ hv search "payments" # Sync with your other machines $ hv sync now # See what's in memory $ hv stats # Add a device: it joins read-only (sterile) until admitted $ hv whoami $ hv admit # on the owner, promotes sterile → fertile, once

Background sync runs as a user service named hive-sync (systemd on Linux and WSL, launchd on macOS), so devices stay in step without you running hv sync by hand.

Support HiveMind

HiveMind is free and open source under the GNU AGPL v3.0. If it helps you, a small donation keeps it alive and independent. Want to get involved instead? Contributions are welcome.

❤ GitHub Sponsors ☕ Ko-fi 🥤 Buy Me a Coffee ⌨ Contribute