{"id":48645361,"url":"https://github.com/activeloopai/hivemind","last_synced_at":"2026-05-13T01:06:33.163Z","repository":{"id":349650779,"uuid":"1200802466","full_name":"activeloopai/hivemind","owner":"activeloopai","description":"One brain for all your agents","archived":false,"fork":false,"pushed_at":"2026-05-07T19:59:11.000Z","size":4676,"stargazers_count":68,"open_issues_count":20,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-07T20:07:09.608Z","etag":null,"topics":["ai","ai-agents","ai-memory","anthropic","artificial-intelligence","claude","claude-agent-sdk","claude-agents","claude-code-plugin","claude-skills","codex","embeddings","long-term-memory","memory-engine","openclaw","openclaw-skills","postgres","rag"],"latest_commit_sha":null,"homepage":"https://deeplake.ai/hivemind","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/activeloopai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-03T21:02:08.000Z","updated_at":"2026-05-07T18:50:37.000Z","dependencies_parsed_at":"2026-05-07T20:03:09.463Z","dependency_job_id":null,"html_url":"https://github.com/activeloopai/hivemind","commit_stats":null,"previous_names":["activeloopai/deeplake-claude-code-plugins","activeloopai/hivemind"],"tags_count":84,"template":false,"template_full_name":null,"purl":"pkg:github/activeloopai/hivemind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeloopai%2Fhivemind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeloopai%2Fhivemind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeloopai%2Fhivemind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeloopai%2Fhivemind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/activeloopai","download_url":"https://codeload.github.com/activeloopai/hivemind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeloopai%2Fhivemind/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32802560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-memory","anthropic","artificial-intelligence","claude","claude-agent-sdk","claude-agents","claude-code-plugin","claude-skills","codex","embeddings","long-term-memory","memory-engine","openclaw","openclaw-skills","postgres","rag"],"created_at":"2026-04-10T03:05:56.711Z","updated_at":"2026-05-13T01:06:33.144Z","avatar_url":"https://github.com/activeloopai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://github.com/activeloopai/hivemind\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/activeloopai/hivemind/main/docs/public/hivemind-logo.svg\" alt=\"Hivemind\" width=\"120\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  Hivemind\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eOne brain for all your agents\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@deeplake/hivemind\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@deeplake/hivemind?color=blue\u0026label=npm\" alt=\"npm\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/activeloopai/hivemind/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/activeloopai/hivemind?style=social\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"package.json\"\u003e\u003cimg src=\"https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg\" alt=\"Node\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://deeplake.ai\"\u003e\u003cimg src=\"https://img.shields.io/badge/Powered%20by-Deeplake-orange.svg\" alt=\"Deeplake\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Auto-learning, cloud-backed shared brain for \u003cb\u003eClaude Code • OpenClaw • Codex • Cursor • Hermes • pi\u003c/b\u003e agents.\u003cbr\u003e\n\u003c/p\u003e\n\n\u003e One engineer's agent figures out a tricky migration on Monday.\n\u003e\n\u003e Tuesday, every agent on the team can execute the pattern.\n\n**Beyond memory.** Hivemind captures every coding-agent interaction in your org as a structured trace, codifies repeated patterns into reusable skills, and propagates those skills to every agent on your team.\n\n- 📥 **Captures** every session's prompts, tool calls, and responses as structured traces in Deeplake\n- 🧠 **Codifies** patterns in those traces into reusable skills, available to every agent on your team\n- 🔍 **Searches** across all traces and skills with lexical retrieval (grep fallback when index unavailable)\n- 🔗 **Propagates** capability across sessions, agents, teammates, and machines in real time\n- 📁 **Intercepts** file operations on `~/.deeplake/memory/` through a virtual filesystem backed by SQL\n- 📝 **Summarizes** sessions into AI-generated wiki pages via a background worker at session end\n\n## Quick start\n\nOne command, all your agents:\n\n```bash\nnpm install -g @deeplake/hivemind \u0026\u0026 hivemind install\n```\n\nThe installer detects every supported assistant on your machine (table below), wires up the hooks, and opens a browser once for login. Restart them after install.\n\n**Install for a specific assistant only:**\n\n```bash\nhivemind install --only claude\nhivemind claude install    # equivalent\nhivemind codex install\nhivemind claw install\nhivemind cursor install\nhivemind hermes install\nhivemind pi install\n```\n\n**Check what's wired up:**\n\n```bash\nhivemind status\n```\n\n**Supported assistants:**\n\n| Platform         | Integration                                      | Auto-capture | Auto-recall |\n|------------------|--------------------------------------------------|--------------|-------------|\n| **Claude Code**  | Marketplace plugin                               | ✅           | ✅          |\n| **OpenClaw**     | Native extension                                 | ✅           | ✅          |\n| **Codex**        | Hooks (`hooks.json`)                             | ✅           | ✅          |\n| **Cursor**       | Hooks (`hooks.json` 1.7+)                        | ✅           | ✅          |\n| **Hermes Agent** | Shell hooks (`config.yaml`) + skill + MCP server | ✅           | ✅          |\n| **pi**           | Extension API (`pi.on(...)`) + skill + AGENTS.md | ✅           | ✅          |\n\n### Alternative install paths\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eClaude Code plugin marketplace\u003c/b\u003e\u003c/summary\u003e\n\nIf you prefer Claude Code's native plugin marketplace:\n\n```\n/plugin marketplace add activeloopai/hivemind\n/plugin install hivemind\n/reload-plugins\n/hivemind:login\n```\n\nAuto-updates on each session start. Manual update: `/hivemind:update`.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eOpenClaw ClawHub\u003c/b\u003e\u003c/summary\u003e\n\n```\nopenclaw plugins install clawhub:hivemind\n```\n\nThen type `/hivemind_login` in chat, click the auth link, and sign in.\n\n#### Commands\n\n| Command | Description |\n|---------|-------------|\n| `/hivemind_login` | Sign in via device flow |\n| `/hivemind_capture` | Toggle capture on/off |\n| `/hivemind_whoami` | Show current org and workspace |\n| `/hivemind_orgs` | List organizations |\n| `/hivemind_switch_org \u003cname\u003e` | Switch organization |\n| `/hivemind_workspaces` | List workspaces |\n| `/hivemind_switch_workspace \u003cid\u003e` | Switch workspace |\n| `/hivemind_update` | Check for plugin updates |\n\nAuto-recall and auto-capture are enabled by default. Data is stored in the same `sessions` table as Claude Code and Codex.\n\n#### Coexistence with `memory-core`\n\nHivemind runs **alongside** OpenClaw's built-in `memory-core` plugin. It does **not** claim the memory slot, so `memory-core`'s dreaming cron (`\"0 3 * * *\"`) and other memory-slot-dependent jobs keep working. Hivemind captures session activity and exposes its own commands; `memory-core` keeps owning recall/promotion/dreaming.\n\n#### Troubleshooting\n\n- **Hivemind seems slow or unresponsive.** Check the agent model in `~/.openclaw/openclaw.json` under `agents.defaults.model`. Hivemind makes many small tool calls per turn; a large reasoning model like Opus will feel sluggish. Recommended default: `anthropic/claude-haiku-4-5-20251001`.\n- **`openclaw model \u003cid\u003e` says \"plugins.allow excludes model\".** The `model` plugin CLI is disabled by default. Edit `~/.openclaw/openclaw.json` directly (key `agents.defaults.model`) and restart the gateway: `systemctl --user restart openclaw-gateway.service`.\n- **Model switch rejected as \"not allowed\".** Use the exact dated provider-prefixed ID (`anthropic/claude-haiku-4-5-20251001`, `anthropic/claude-sonnet-4-6`). Legacy IDs like `claude-3-5-haiku-latest` and unprefixed bare IDs are not on OpenClaw's allowlist.\n- **Self-update via Telegram fails with \"elevated is not available\".** `tools.elevated.allowFrom` must include `telegram` before elevated commands work from that channel. Safer alternative: run the upgrade in a local shell with `openclaw plugins update hivemind`.\n- **`npm error EACCES` during self-update.** OpenClaw was installed under a root-owned npm prefix (e.g. `/usr/lib/node_modules/openclaw`). Reinstall under a user-writable prefix, or run the update with appropriate privileges locally — not via a channel.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eCodex (manual)\u003c/b\u003e\u003c/summary\u003e\n\nTell Codex to fetch and follow the install instructions:\n\n```\nFetch and follow instructions from https://raw.githubusercontent.com/activeloopai/hivemind/main/codex/INSTALL.md\n```\n\nOr run the installer script directly:\n\n```bash\ngit clone https://github.com/activeloopai/hivemind.git ~/.codex/hivemind\n~/.codex/hivemind/codex/install.sh\n```\n\nRestart Codex to activate.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eCursor (1.7+)\u003c/b\u003e\u003c/summary\u003e\n\nThe unified installer wires six lifecycle events in `~/.cursor/hooks.json` — sessionStart, beforeSubmitPrompt, postToolUse, afterAgentResponse, stop, sessionEnd. Hooks fork a Node bundle at `~/.cursor/hivemind/bundle/` per event. Restart Cursor after install to load.\n\n```bash\nhivemind cursor install\n```\n\nAuto-capture is enabled the same way as Claude Code / Codex / OpenClaw.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eHermes Agent\u003c/b\u003e\u003c/summary\u003e\n\nWires shell hooks into `~/.hermes/config.yaml` (`pre_llm_call` / `post_tool_call` / `post_llm_call` / `on_session_end`) for auto-capture, drops the bundle at `~/.hermes/hivemind/bundle/`, registers the shared MCP server (`~/.hivemind/mcp/server.js`) under `mcp_servers.hivemind`, and installs an `agentskills.io`-compatible skill at `~/.hermes/skills/hivemind-memory/` for recall.\n\n```bash\nhivemind hermes install\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003epi (badlogic/pi-mono coding-agent)\u003c/b\u003e\u003c/summary\u003e\n\nUpserts an idempotent BEGIN/END marker block into `~/.pi/agent/AGENTS.md` (auto-loaded every turn) and drops a TypeScript extension at `~/.pi/agent/extensions/hivemind.ts`. The extension subscribes to pi's lifecycle events (`session_start` / `input` / `tool_result` / `message_end`) for auto-capture and registers `hivemind_search`, `hivemind_read`, `hivemind_index` as first-class pi tools.\n\n```bash\nhivemind pi install\n```\n\nNote: no per-agent SKILL.md is dropped under `~/.pi/agent/skills/` — pi reads skills from both that directory AND the shared `~/.agents/skills/` location. If the codex installer has run on the same machine, pi picks up the hivemind skill from the shared `~/.agents/skills/hivemind-memory` symlink automatically. The AGENTS.md block plus the registered tools cover the action surface in either case.\n\u003c/details\u003e\n\n\n### Uninstall\n\n```bash\nhivemind uninstall              # remove from every detected assistant\nhivemind codex uninstall        # remove from one\n```\n\n## How it works\n\n**Capture → Codify → Propagate → Compound.** Every coding-agent interaction (prompt, tool call, response) is captured as a structured trace in Deeplake. A background worker mines traces for repeated patterns and codifies them into `SKILL.md` files, scoped to your workspace. Codified skills propagate into every Hivemind-connected agent's context at inference time. The agent your junior engineer used this morning is sharper because of what your senior engineer's agent figured out last week.\n\n## Features\n\n### 🔍 Natural search\n\nJust ask your agent naturally:\n\n```\n\"What was Emanuele working on?\"\n\"Search traces for authentication bugs we've solved\"\n\"What did we decide about the API design?\"\n\"Show me skills my team has codified for handling migrations\"\n```\n\n### 🔒 Privacy controls\n\nDisable capture entirely:\n\n```bash\nHIVEMIND_CAPTURE=false claude\n```\n\nEnable debug logging:\n\n```bash\nHIVEMIND_DEBUG=1 claude\n```\n\n## ⚠️ Data collection notice\n\nThis plugin captures session activity and stores it in your Deeplake workspace:\n\n| Data                  | What's captured                    |\n|-----------------------|------------------------------------|\n| User prompts          | Every message you send             |\n| Tool calls            | Tool name + full input             |\n| Tool responses        | Full tool output                   |\n| Assistant responses   | The agent's final response         |\n| Subagent activity     | Subagent tool calls and responses  |\n| Codified skills       | Patterns extracted from traces     |\n\n**All users in your Deeplake workspace can read this data.** That's the design — shared capability requires shared substrate. A DATA NOTICE is displayed at the start of every session. Workspace-level isolation prevents data leakage between orgs.\n\n## Configuration\n\n| Variable                  | Default                   | Description                                |\n|---------------------------|---------------------------|--------------------------------------------|\n| `HIVEMIND_TOKEN`          | —                         | API token (auto-set by login)              |\n| `HIVEMIND_ORG_ID`         | —                         | Organization ID (auto-set by login)        |\n| `HIVEMIND_WORKSPACE_ID`   | `default`                 | Workspace name                             |\n| `HIVEMIND_API_URL`        | `https://api.deeplake.ai` | API endpoint                               |\n| `HIVEMIND_TABLE`          | `memory`                  | SQL table for summaries and virtual FS     |\n| `HIVEMIND_SESSIONS_TABLE` | `sessions`                | SQL table for per-event session capture    |\n| `HIVEMIND_MEMORY_PATH`    | `~/.deeplake/memory`      | Path that triggers interception            |\n| `HIVEMIND_CAPTURE`        | `true`                    | Set to `false` to disable capture          |\n| `HIVEMIND_EMBEDDINGS`     | `true`                    | Set to `false` to force lexical-only mode  |\n| `HIVEMIND_DEBUG`          | —                         | Set to `1` for verbose hook debug logs     |\n\n## Semantic search (optional)\n\nHivemind ships with a local embedding daemon (nomic-embed-text-v1.5) for hybrid semantic + lexical search over `~/.deeplake/memory/`. **Off by default** because the dependency footprint is ~600 MB. Enable with `hivemind embeddings install` (or `hivemind install --with-embeddings`). Without it, search degrades silently to BM25/lexical-only.\n\nFull guide: **[docs/EMBEDDINGS.md](docs/EMBEDDINGS.md)**.\n\n## Summaries\n\nAfter each session, a background worker generates an AI-written wiki summary and stores it in the `memory` table alongside its 768-dim embedding. Long sessions checkpoint mid-session every 50 messages or 2 hours (configurable). The wiki worker shells out to the host agent's own CLI (`claude -p`, `codex exec`, `pi --print`, …) — no separate API key. Browse summaries at `~/.deeplake/memory/summaries/`.\n\nTriggers, generation flow, and env-var reference: **[docs/SUMMARIES.md](docs/SUMMARIES.md)**.\n\n## Skills (skillify)\n\nHivemind **codifies recurring patterns from your team's recent sessions into reusable skills** that propagate to every agent on your team — automatically. An async background worker fires on Stop / SessionEnd, mines recent sessions in scope, asks Haiku whether the activity contains something worth keeping, and writes a `SKILL.md` to `\u003cproject\u003e/.claude/skills/\u003cname\u003e/`.\n\n```bash\nhivemind skillify                            # show current scope, team, install, per-project state\nhivemind skillify scope \u003cme|team|org\u003e        # who counts as \"in scope\" for mining\nhivemind skillify pull                       # install teammates' skills locally\nhivemind skillify unpull                     # remove pulled skills\n```\n\nTriggers, generation flow, full `pull` / `unpull` semantics, gate-CLI table per agent, env vars, logs: **[docs/SKILLIFY.md](docs/SKILLIFY.md)**.\n\n## Architecture\n\nPer-agent integration mechanisms (marketplace plugin, hooks, skills, native extension) and monorepo structure: **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)**.\n\n## Roadmap\n\n- **Trajectory export for fine-tuning.** Because traces are stored in Deeplake's tensor format, they're export-ready as PyTorch datasets. Teams running their own open-source models can fine-tune on their org's accumulated trajectories. A handful of advanced customers are already doing this against the trajectories their Claude Code and Codex agents generated.\n- **GPU-accelerated dense retrieval at scale.** Local CPU embeddings already ship via the optional nomic-embed daemon (see [Semantic search](#semantic-search-optional)). Next: GPU-accelerated vector search over the full trace store, on by default.\n- **Skill versioning and review.** Pre-release human review for codified skills before they propagate org-wide, for teams that want a curation step.\n- **More agents.** If your team uses an agent that isn't on the supported-assistants list above, open an issue.\n\n## Security\n\n- SQL values escaped with `sqlStr()`, `sqlLike()`, `sqlIdent()`\n- ~70 allowlisted builtins run in the virtual FS; unrecognized commands are denied\n- Credentials stored with mode `0600`, config dir with mode `0700`\n- Device flow login: no tokens in environment or code\n- `HIVEMIND_CAPTURE=false` fully disables data collection\n\n## Development\n\n```bash\ngit clone https://github.com/activeloopai/hivemind.git\ncd hivemind\nnpm install\nnpm run build     # tsc + esbuild → claude-code/bundle/ + codex/bundle/ + cursor/bundle/ + openclaw/dist/ + mcp/bundle/ + bundle/cli.js\nnpm test          # vitest\n```\n\nTest locally with Claude Code:\n\n```bash\nclaude --plugin-dir claude-code\n```\n\nInteractive shell against Deeplake:\n\n```bash\nnpm run shell\n```\n\n## License\n\nApache License 2.0 — © Activeloop, Inc. See [LICENSE](LICENSE) for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factiveloopai%2Fhivemind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factiveloopai%2Fhivemind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factiveloopai%2Fhivemind/lists"}