claude-mem — Agent Guide

No conflict-matrix pairs for this tool yet.

# Claude-Mem — Agent Guide

name: claude-mem ｜ version_range: 13.18.0~13.18.0｜ generated: 2026-08-28

title_en: Claude Mem - Persistent Cross-Session Memory ｜ desc_en: Captures sessions, compresses with AI and injects relevant context across sessions (MCP + worker).

Preflight

note: Requires Node >= 18; worker runtime requires Bun.

node --version && (command -v bun >/dev/null && echo bun-ok || echo bun-missing)

预期输出: see command output

Install

note: npmmirror recommended in mainland China. Write surface: ~/.claude.json, ~/.claude/plugins/, ~/.claude/backups/, ~/.claude-mem/.

npm_config_registry=https://registry.npmmirror.com npm install -g claude-mem
claude-mem install --ide claude-code

预期输出: Installation Complete（Plugin dir: ~/.claude/plugins/marketplaces/thedotmack；Worker port: 37700）

Operations

View status

note: Verified in this environment.

claude-mem status

预期输出: Worker is not running（未启动时）；启动后显示端口与记忆数

Start worker

note: Starts memory capture and UI service.

claude-mem start

预期输出: worker started (memory UI http://localhost:37700; /mem-search available inside Claude Code)

Search memory

claude-mem search "部署问题"

预期输出: list of relevant observations/memory snippets

Worktree memory integration

note: After merging a branch; dry-run first.

claude-mem adopt --dry-run

预期输出: list of worktree memories pending integration (drop --dry-run to confirm)

Stop worker

claude-mem stop

预期输出: worker stopped

Uninstall

note: Official uninstall restores ~/.claude.json backup; close all Claude Code sessions first.

claude-mem uninstall 2>/dev/null || true
npm rm -g claude-mem 2>/dev/null || true
rm -rf ~/.claude-mem
command -v claude-mem >/dev/null 2>&1 && echo '残留: claude-mem 仍存在' || echo 'claude-mem removed: OK'

预期输出: claude-mem removed: OK

Facts

writes: ~/.claude.json, ~/.claude/plugins/, ~/.claude/backups/, ~/.claude-mem/ ｜ runtime: Node >= 18, Bun for worker ｜ notes: background worker on port 37700; stop with claude-mem stop

Source: claude-mem · validated 2026-08-28 · v13.18.0~13.18.0

← Agent index