backup-config

Backup Config

Backup and restore Claude Code configuration files.

Usage

/backup-config [action] [name]

Platform Compatibility

Platform	Status	Notes
Windows	✅	Requires Git Bash (included with Git for Windows)
macOS	✅	Works with bash/zsh
Linux	✅	Works with bash

All commands use POSIX utilities (mkdir, cp, ls, date).

Arguments

Argument	Default	Options
action	create	create, list, restore
name	auto-[timestamp]	Custom backup name

Backup Location

~/.claude/.backups/

Actions

create (default)

Create a new backup:

# Create backup directory
mkdir -p ~/.claude/.backups

# Generate backup name
BACKUP_NAME="${name:-backup-$(date +%Y%m%d-%H%M%S)}"
BACKUP_DIR=~/.claude/.backups/$BACKUP_NAME

mkdir -p "$BACKUP_DIR"

# Backup critical files
cp ~/.claude/settings.json "$BACKUP_DIR/"
cp ~/.claude/CLAUDE.md "$BACKUP_DIR/"
cp ~/.claude/.mcp.json "$BACKUP_DIR/" 2>/dev/null || true

# Create manifest
echo "Backup: $BACKUP_NAME" > "$BACKUP_DIR/manifest.txt"
echo "Created: $(date)" >> "$BACKUP_DIR/manifest.txt"
echo "Files:" >> "$BACKUP_DIR/manifest.txt"
ls -la "$BACKUP_DIR" >> "$BACKUP_DIR/manifest.txt"

echo "Backup created: $BACKUP_DIR"

list

List available backups:

echo "Available backups:"
echo ""
ls -lt ~/.claude/.backups/ | head -20
echo ""
echo "Total: $(ls ~/.claude/.backups/ | wc -l) backups"

restore

Restore from backup:

BACKUP_DIR=~/.claude/.backups/$name

if [ ! -d "$BACKUP_DIR" ]; then
  echo "Backup not found: $name"
  echo "Use '/backup-config list' to see available backups"
  exit 1
fi

# Create safety backup first
mkdir -p ~/.claude/.backups/pre-restore-$(date +%Y%m%d-%H%M%S)
cp ~/.claude/settings.json ~/.claude/.backups/pre-restore-*/

# Restore files
cp "$BACKUP_DIR/settings.json" ~/.claude/
cp "$BACKUP_DIR/CLAUDE.md" ~/.claude/ 2>/dev/null || true
cp "$BACKUP_DIR/.mcp.json" ~/.claude/ 2>/dev/null || true

echo "Restored from: $BACKUP_DIR"
echo "Note: Restart Claude Code for changes to take effect"