eric-cielo/moflo / .claude/skills/memory-worktree
memory-worktree
UnverifiedVerify, customize, or opt out of moflo's AUTOMATIC durable-learning sharing across git worktrees / Conductor workspaces on one machine. As of the worktree-auto-sharing change this is on by default — learnings converge across a repo's worktrees with no setup. Use when the user asks "is memory shared across my worktrees?", "where are my worktree learnings stored?", "turn off worktree memory sharing", "share learnings across my separate clones", or "point my worktrees at a custom store". For a team or cross-machine (git-tracked) sharing, use /memory-team instead.
/memory-worktree — Durable Sharing Across Worktrees (Automatic)
Working across git worktrees is a core moflo competency, so durable-learning sharing across the
worktrees of a repo is now automatic and on by default. When a checkout is part of a repo with
worktrees in play, moflo derives a shared durable store at <git-common-dir>/moflo/durable.db and
converges the learnings + knowledge namespaces across every worktree at session start — no config.
A plain single checkout writes nothing and behaves exactly as before.
This skill is for the three things you might still want: verify it's working, customize where it stores (or extend it to non-worktree clones), or opt out.
Only the durable slice travels. Structural + ephemeral data stays local per checkout and rebuilds itself — the same safety model the auto path is built on (a dedicated
durable.db, never a fullmoflo.db). See [[memory-team]] for the git-tracked, cross-machine variant.
Arguments: $ARGUMENTS — --off to opt out, --path <store> to set a custom shared store.
When to use
- "Is memory / are learnings shared across my worktrees?" → verify (Step 1).
- "Where are my worktree learnings stored?" → it's
<git-common-dir>/moflo/durable.db; verify to confirm. - "Turn off / disable worktree memory sharing" → opt out (Step 2).
- "Share learnings across my separate clones / a custom location" → customize (Step 3).
For a team, or your own laptop+desktop over git, that's /memory-team, not this.
Procedure
Step 0 — Memory first (gate requirement)
mcp__moflo__memory_search { query: "durable_path worktree sharing auto git common dir learnings", namespace: "guidance" }
Step 1 — Verify (default action)
Run the safety/status check and surface it verbatim:
npx flo doctor -c shared-db 2>&1
- "Automatic worktree learning sharing active ()" → it's working; the path is the shared store.
- "No shared full moflo.db detected…" → auto sharing is NOT active here. Most likely this checkout has no sibling worktrees yet (auto only turns on once worktrees exist). Confirm with the user; if they expected sharing across separate clones (not worktrees), go to Step 3 — auto can't converge those.
- A
warn→ a full-DB misconfig is present; follow the check'sfixline.
To see that learnings actually converged, from a second worktree:
npx flo memory list --namespace learnings 2>&1 | head
Step 2 — Opt out (--off)
If the user wants it off, set the toggle in the project-root moflo.yaml (preserve other memory: keys):
memory:
worktree_sharing: false
Explain: this stops the auto flush/seed at session start. Anything already converged into a worktree's local DB stays; nothing new propagates. Takes effect next session.
Step 3 — Customize the store (--path, or non-worktree clones)
Setting an explicit memory.durable_path overrides the auto derivation — use it to:
- put the shared store somewhere other than
.git/moflo/(e.g. a synced/backed-up location), or - converge checkouts that are separate clones, not git worktrees (auto only covers worktrees, since only worktrees share a git common dir).
memory:
durable_path: ~/.moflo-shared/<repo-name>-learnings.db
The path must live outside any single checkout and must not be named moflo.db. Create the parent
dir with a Node primitive (cross-platform — never mkdir -p):
node -e "const p=require('path'),fs=require('fs');fs.mkdirSync(p.dirname(process.argv[1]),{recursive:true})" "<chosen-store-path>"
Then re-run npx flo doctor -c shared-db to confirm it reports the durable-only store as safe.
Output
End with a single-block summary of what state you left it in, e.g.:
Worktree Memory Sharing
────────────────────────
Mode: automatic (default) | custom durable_path | disabled
Store: <git-common-dir>/moflo/durable.db (or the custom/none path)
Config: memory.worktree_sharing / memory.durable_path
Verify: npx flo doctor -c shared-db
Scope: learnings + knowledge only (structural stays local)
Rules
- Don't re-implement the sync or path derivation — it's
resolveDurablePath/syncDurableAtSessionStartinsrc/cli/services/durable-sync.ts; this skill only reads config, sets the two keys, and verifies. - Never set
durable_pathto a file namedmoflo.dbor the local.moflo/moflo.db— that's the HNSW-index-divergence hazardflo doctor -c shared-dbguards against. - Don't use
mkdir -p/rm/cpin shell steps — Windows lacks them on PATH. Use Nodefs. - Cross-machine or team? Wrong skill. Redirect to
/memory-team.
See Also
/memory-team— git-tracked JSONL sharing for teams and one person across machinesflo doctor -c shared-db— reports auto-sharing status and catches full-DB misconfigdocs/blog/memory-sharing.html— the design rationale (durable vs structural vs ephemeral)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |