memory-backup — Agent Memory Backup & Restore

Creates compressed backups of agent memory/chat history and restores from previous snapshots. Supports configurable retention policies and scheduled execution via cron.

Usage

# Back up agent memory (default source: ~/.agent-memory)
python3 memory_backup.py backup

# Back up a custom source with retention of 5 snapshots
python3 memory_backup.py backup --source ~/my-memory --retention 5

# List all available backup points
python3 memory_backup.py list

# Restore from a specific backup
python3 memory_backup.py restore --restore-from ~/.agent-memory-backups/memory_backup_20240115_120000.tar.gz

Parameters

Flag	Default	Description
--source	~/.agent-memory	Memory source directory or file
--backup-dir	~/.agent-memory-backups	Where backups are stored
--retention	10	Keep N most recent backups (0 = keep all)
--restore-from	—	Backup file path (required for restore)
--restore-to	~/.agent-memory	Restore destination
--output	json	Output format (json or print)

Output examples

Backup:

{"status": "ok", "path": "/Users/you/.agent-memory-backups/memory_backup_20240115_120000.tar.gz", "retention": 10}

List:

{"backups": [{"path": "...", "name": "memory_backup_20240115_120000.tar.gz", "created": "2024-01-15T12:00:00"}], "count": 1}

Restore:

{"status": "ok", "restored_to": "/Users/you/.agent-memory"}

Scheduled backups (cron)

0 */6 * * * cd /path/to/skill && python3 memory_backup.py backup

Error handling

• Source not found: returns {"error": "Source not found: <path>"}
• Missing --restore-from: returns {"error": "--restore-from required for restore"}
• Restore overwrites destination: existing files at restore target are replaced — back up first if uncertain

Related skills

• session-memory: the data source this skill backs up
• calendar: trigger scheduled backups
• file-organizer: manage backup files