hivemind-memory

# Hivemind Memory You have persistent memory at `~/.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 1. **First**: Read `~/.deeplake/memory/index.md` — quick scan of all sessions with dates, projects, descriptions 2. **If you need details**: Read the specific summary at `~/.deeplake/memory/summaries/<session>.md` 3. **If you need raw data**: Read the session JSONL at `~/.deeplake/memory/sessions/<user>/<file>.jsonl` 4. **Keyword search**: `grep -r "keyword" ~/.deeplake/memory/` Do NOT jump straight to reading raw JSONL files. Always start with index.md and summaries. ## Organization Management Each argument is separate — do NOT quote subcommands together. The auth command is at `$PLUGIN_ROOT/bundle/commands/auth-login.js` (or check the session context for the resolved path): - `node "<path>/auth-login.js" login` — SSO login - `node "<path>/auth-login.js" whoami` — show current user/org - `node "<path>/auth-login.js" org list` — list organizations - `node "<path>/auth-login.js" org switch <name-or-id>` — switch organization - `node "<path>/auth-login.js" workspaces` — list workspaces - `node "<path>/auth-login.js" workspace <id>` — switch workspace - `node "<path>/auth-login.js" invite <email> <ADMIN|WRITE|READ>` — invite member (ALWAYS ask user which role first) - `node "<path>/auth-login.js" members` — list members - `node "<path>/auth-login.js" remove <user-id>` — remove member - `node "<path>/auth-login.js" --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 state - `hivemind skillify pull` — sync project skills from the org table to local FS - `hivemind skillify pull --user <email>` — only skills authored by that user - `hivemind 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) - `hivemind skillify pull --dry-run` — preview without touching disk - `hivemind 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 table - `hivemind skillify unpull` — remove every skill previously installed by pull - `hivemind skillify unpull --user <email>` — remove only that author's pulls - `hivemind skillify unpull --not-mine` — remove all pulls except your own - `hivemind skillify unpull --dry-run` — preview without touching disk - `hivemind skillify scope <me|team>` — sharing scope for newly mined skills - `hivemind skillify install <project|global>` — default install location for new skills - `hivemind skillify promote <skill-name>` — move a project skill to the global location - `hivemind skillify team add|remove|list <username>` — manage team member list - `hivemind 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:true - `hivemind 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 too - `hivemind 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 Do NOT spawn subagents to read deeplake memory. 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: 1. Authenticate with `node "<AUTH_CMD>" login` 2. Start using memory — ask questions, Codex automatically captures and searches ## Configuration - `HIVEMIND_DEBUG=1 codex` — enable verbose logging to `~/.deeplake/hook-debug.log` - `HIVEMIND_CAPTURE=false codex` — disable session capture