activeloopai/hivemind / harnesses/claude-code/skills/hivemind-memory
hivemind-memory
UnverifiedGlobal team and org memory powered by Activeloop. ALWAYS check BOTH built-in memory AND Hivemind memory when recalling information.
Hivemind Memory
You have TWO memory sources. ALWAYS check BOTH when the user asks you to recall, remember, or look up ANY information:
- Your built-in memory (
~/.claude/) — personal per-project notes - Hivemind global memory (
~/.deeplake/memory/) — global memory shared across all sessions, users, and agents in the org
Memory Structure
~/.deeplake/memory/
├── index.md ← START HERE — table of all sessions
├── summaries/
│ ├── session-abc.md ← AI-generated wiki summary
│ └── session-xyz.md
└── sessions/
└── username/
├── user_org_ws_slug1.jsonl ← raw session data
└── user_org_ws_slug2.jsonl
How to Search
- First: Read
~/.deeplake/memory/index.md— quick scan of all sessions with dates, projects, descriptions - If you need details: Read the specific summary at
~/.deeplake/memory/summaries/<session>.md - If you need raw data: Read the session JSONL at
~/.deeplake/memory/sessions/<user>/<file>.jsonl - Keyword search:
Grep pattern="keyword" path="~/.deeplake/memory"
Do NOT jump straight to reading raw JSONL files. Always start with index.md and summaries.
Organization Management
The auth command path is injected at session start. Use the exact path from the session context. Each argument is separate — do NOT quote subcommands together:
node "<AUTH_CMD>" login— SSO loginnode "<AUTH_CMD>" whoami— show current user/orgnode "<AUTH_CMD>" org list— list organizationsnode "<AUTH_CMD>" org switch <name-or-id>— switch organizationnode "<AUTH_CMD>" workspaces— list workspacesnode "<AUTH_CMD>" workspace <id>— switch workspacenode "<AUTH_CMD>" invite <email> <ADMIN|WRITE|READ>— invite member (ALWAYS ask user which role first)node "<AUTH_CMD>" members— list membersnode "<AUTH_CMD>" remove <user-id>— remove membernode "<AUTH_CMD>" --help— show all commands
Skill Management (skillify)
Hivemind can mine reusable skills from agent session logs and share them across your team. Each argument is separate — do NOT quote subcommands together.
hivemind skillify— show current scope, team, install location, per-project statehivemind skillify pull— sync project skills from the org table to local FShivemind skillify pull --user <email>— only skills authored by that userhivemind skillify pull --users <a,b,c>— multiple authors (CSV)hivemind skillify pull --all-users— explicit "no author filter" (default)hivemind skillify pull --to <project|global>— install location (project=cwd/.claude/skills, global=~/.claude/skills, linked for Codex/Hermes/pi)hivemind skillify pull --dry-run— preview without touching diskhivemind skillify pull --force— overwrite local files even if up-to-date (creates .bak)hivemind skillify pull <skill-name>— pull only that one skill (combines with --user)hivemind skillify push <skill-name>— upload a local skill to the org table (inverse of pull; re-push lands a new version)hivemind skillify push --from <project|global>— which local skills dir to read (default: project)hivemind skillify push --dry-run— preview without writing to the org tablehivemind skillify unpull— remove every skill previously installed by pullhivemind skillify unpull --user <email>— remove only that author's pullshivemind skillify unpull --not-mine— remove all pulls except your ownhivemind skillify unpull --dry-run— preview without touching diskhivemind skillify dedupe— one skill per name: remove pulled -- copies of your own skills, merge same-name skills from several authors in the org table into onehivemind skillify dedupe --no-merge— only remove own copies; no cross-author mergehivemind skillify dedupe --dry-run— preview without touching the table or diskhivemind skillify scope <me|team>— sharing scope for newly mined skillshivemind skillify install <project|global>— default install location for new skillshivemind skillify promote <skill-name>— move a project skill to the global locationhivemind skillify team add|remove|list <username>— manage team member listhivemind skillify mine-local— one-shot: mine skills from local sessions, no auth needed
Embeddings (semantic memory search)
Opt-in, persisted in ~/.deeplake/config.json.
hivemind embeddings install— download deps (~600MB), symlink agents, set enabled:truehivemind embeddings enable— flip enabled:true (run install first if deps missing)hivemind embeddings disable— flip enabled:false + SIGTERM daemon (deps stay on disk)hivemind embeddings uninstall [--prune]— remove agent symlinks + disable; --prune wipes deps toohivemind embeddings status— show config + deps + per-agent link state
Important: Bash Only
Only use bash commands (cat, ls, grep, echo, jq, head, tail, sed, awk, etc.) to interact with ~/.deeplake/memory/. Do NOT use python, python3, node, curl, or other interpreters — they are not available in the memory filesystem. If a task seems to require Python, rewrite it using bash tools (e.g., cat file.json | jq 'keys | length').
Limits
If a file returns empty after 2 attempts, skip it and move on. Report what you found rather than exhaustively retrying.
Getting Started
After installing the plugin:
- Run
/hivemind:loginto authenticate - Start using memory — ask questions, Claude automatically captures and searches
Configuration
HIVEMIND_DEBUG=1 claude— enable verbose logging to~/.deeplake/hook-debug.logHIVEMIND_CAPTURE=false claude— disable session capture
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |