unify-worktree-memory

将 Claude Code 的记忆整合至 Git 工作树中，使同一仓库的所有分支共享单一的记忆目录。适用于工作树间记忆隔离、切换分支时容易丢失上下文，或在基于工作树的工作流程中搭建新机器时使用。

SKILL.md

--- frontmatter

name: unify-worktree-memory
description: |
  Consolidate Claude Code memory across git worktrees so all branches of the
  same repo share a single memory directory. Use when memory is isolated per
  worktree, when switching branches loses context, or when setting up a new
  machine with worktree-based workflows.
triggers:
  # Direct invocations
  - unify-worktree-memory
  - /unify-worktree-memory
  # Problem descriptions
  - memory isolated per worktree
  - worktree memory not shared
  - losing memory when switching branches
  - each worktree has separate memory
  - memory not shared across worktrees
  - consolidate memory
  - share memory across worktrees
  - worktree memory consolidation
  # Setup / configuration
  - set up worktree memory sharing
  - configure shared memory
  - symlink memory across worktrees
  - worktree symlink
  # Claude Code + worktree
  - claude code worktree
  - claude memory worktree
  - claude worktree branch
  - project memory sharing

unify-worktree-memory

Open @references/guide.md and follow it. Do not proceed without it.

Consolidate Claude Code's per-project memory across git worktrees so every branch of the same repo shares accumulated knowledge. The solution uses symlinks (Claude Code follows them transparently) and a SessionStart hook for automatic setup of future worktrees.

The guide contains:

•How Claude Code memory paths work and why worktrees fragment them
•One-time consolidation script for existing worktrees
•SessionStart hook for automatic future worktree handling
•Path encoding rules and prefix collision disambiguation
•Edge cases: orphaned worktrees, ambiguous repo name prefixes, content merging