Starstruk Logo MarkStarstruk

v12.2.0

thedotmack/claude-memv12.2.0Apr 18, 2026by thedotmack

AI Summary

This release introduces worktree adoption capabilities, allowing observations from merged git worktrees to be consolidated into their parent project's view. It adds a new CLI command for manual adoption, auto-adoption on worker startup, and various UI and query improvements.

Key Highlights

  • Worktree adoption engine consolidates merged worktree observations under parent project
  • New CLI command `npx claude-mem adopt` with `--dry-run` and `--branch X` flags
  • Auto-adoption of merged worktrees when worker service starts
  • CWD-based project remap derives project identity from `pending_messages.cwd`
  • UI now displays merged-into-parent badge for adopted observations

New Features

  • Worktree adoption engine — consolidates merged-worktree observations under the parent project (#2052)
  • `npx claude-mem adopt` — new CLI command with `--dry-run` and `--branch X` flags for manual adoption
  • Auto-adoption on worker startup — merged worktrees are adopted automatically when the worker service starts
  • CWD-based project remap — project identity derived from `pending_messages.cwd`, applied on worker startup
  • Parent + worktree read scope — worktree sessions now include parent repo observations in their read scope
  • Composite project names — parent/worktree naming prevents observations from crossing worktrees
  • Merged-into-parent badge — UI now flags observations that have been adopted from a merged worktree
  • Observer-sessions project hidden — internal bookkeeping project no longer appears in UI lists

Full Release Notes

## Highlights

**Worktree Adoption** — When a git worktree is merged back into its parent branch, its observations are now consolidated into the parent project's view, so memory follows the code after a merge.

## Features

- **Worktree adoption engine** — consolidates merged-worktree observations under the parent project (#2052)
- **`npx claude-mem adopt`** — new CLI command with `--dry-run` and `--branch X` flags for manual adoption
- **Auto-adoption on worker startup** — merged worktrees are adopted automatically when the worker service starts
- **CWD-based project remap** — project identity derived from `pending_messages.cwd`, applied on worker startup
- **Parent + worktree read scope** — worktree sessions now include parent repo observations in their read scope
- **Composite project names** — parent/worktree naming prevents observations from crossing worktrees
- **Merged-into-parent badge** — UI now flags observations that have been adopted from a merged worktree
- **Observer-sessions project hidden** — internal bookkeeping project no longer appears in UI lists

## Fixes

- Drop orphan flag when filtering empty-string spawn args (#2049)
- Self-heal Chroma metadata on re-run
- Schema guard, startup adoption path, and query parity hardening
- Git operation timeouts + dry-run sentinel fixes
- Context derivation uses explicit `projects` array rather than cwd

## Chores

- Removed auto-generated per-directory `CLAUDE.md` files across the tree

**Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v12.1.6...v12.2.0