memory-sync — Claude Code memory backup and sync

Getting started

Install

# via gago-plugins marketplace
/plugin marketplace add gagoar/gago-plugins
/plugin install memory-sync@gago-plugins
/reload-plugins

# standalone
/plugin marketplace add gagoar/claude-memory-sync
/plugin install memory-sync@memory-sync
/reload-plugins

After installing the plugin, run /memory-sync:sync init to connect your backup repo.

Configuration

First-time setup

/memory-sync:sync init

AsksWhere to put your backup repo — creates a private GitHub repo if you don't have one
ConfiguresEverything in ~/.claude/memory-sync.config.json — no other setup needed
Auto-runsThe first time you invoke any /memory-sync:sync command without a config

You can also say "back up my memory" or "set up memory backup" — Claude routes to the same init flow.

Reference

Daily use

You type	What happens
`/memory-sync:sync push`	Back up new/changed memory + global config to your repo
`/memory-sync:sync pull`	Restore from your repo
`/memory-sync:sync status`	See what files have drifted
`/memory-sync:sync list`	Show projects and global files that are backed up
`/memory-sync:sync select`	Pick which projects to include (interactive checkboxes)
`/memory-sync:sync history`	Show recent backup commits — what was backed up when
`/memory-sync:sync configure --backup-repo=NEW`	Switch backup destination

push no-opsWhen nothing has changed, push exits cleanly with no commit
pull safetyRefuses to overwrite local changes unless --force is passed

Portability

HOME-relative storage

Claude encodes the absolute path of each project as the local directory name. This plugin stores the suffix after your $HOME prefix so memories restore on any machine.

Location	Path
Machine A local	`~/.claude/projects/-Users-alice-base-foo/memory/...`
Stored in repo	`data/home-projects/base-foo/memory/...`
Machine B local	`~/.claude/projects/-Users-bob-base-foo/memory/...`

Outside $HOMEProjects outside $HOME live under data/absolute-projects/ and restore only on machines with the same absolute path.

Data & security

Privacy

This plugin repo is public and contains no user data. Your backup repo is yours — use a private repo, memory often contains project names, hostnames, and identifiers. The plugin only reads/writes ~/.claude/projects/*/memory/ and your backup repo.