mem-link

mem-link

A Claude Code plugin that surfaces Claude's auto-memory MEMORY.md at the project root via a symlink — so the recall index is editable and visible from $CWD without losing the selection→synthesis retrieval pipeline.

What it solves

Claude Code's auto-memory writes per-project state to a deeply-nested user-state path:

~/.claude/projects/<cwd-with-/-replaced-by-->/memory/MEMORY.md

That's inconvenient to open, browse, or include in repo tooling. mem-link drops a symlink at $CWD/MEMORY.md pointing at the real file — same retrieval pipeline, accessible location.

Install

# 1. Add the marketplace
/plugin marketplace add teocns/mem-link

# 2. Install the plugin
/plugin install mem-link@mem-link

Then /reload-plugins (or restart Claude Code) to activate.

Commands

Command	Behavior
/mem-link	One-shot: create the symlink in the current $CWD now.
/mem-link auto	Enable: every SessionStart will attempt the link (global flag).
/mem-link off	Disable: SessionStart hook is a no-op. Existing symlinks left intact.
/mem-link status	Report auto state + what currently sits at $CWD/MEMORY.md.

Zero-token — every subcommand is handled by a UserPromptSubmit hook, no API call.

Defaults

Auto-link is OFF by default. The plugin will not touch your filesystem until you explicitly run /mem-link (one-shot) or /mem-link auto (every session).

Safety contract

mem-link will never overwrite or replace:

• a regular file at $CWD/MEMORY.md
• a symlink already pointing somewhere else
• anything at $HOME/MEMORY.md (refused outright)

On any of those, it reports skipped — <reason> and leaves the path alone.

Auto-memory required

This plugin is useful only when Claude Code's auto-memory feature is enabled (autoMemoryEnabled: true in ~/.claude/settings.json — the default). If you've turned auto-memory off, the symlink will point at a file Claude never writes to. The commands warn about this when they detect it.

State

The auto-on-startup flag is a single touch-file:

~/.claude/.mem-link-auto

Global across all projects. Toggle with /mem-link auto and /mem-link off.

License

MIT — see LICENSE.