cron-backup

---
name: cron-backup
description: Set up scheduled automated backups with version tracking and cleanup. Use when users need to (1) Schedule periodic backups of directories or files, (2) Monitor version changes and backup on updates, (3) Automatically clean up old backups to save space, (4) Create backup strategies for configuration files, code repositories, or user data.
---

# Cron Backup

Automated backup scheduling with version detection and intelligent cleanup.

## Quick Start

### One-Time Backup
```bash
# Backup a directory with timestamp
./scripts/backup.sh /path/to/source /path/to/backup/dir

# Backup with custom name
./scripts/backup.sh /path/to/source /path/to/backup/dir my-backup
```

### Schedule Daily Backup
```bash
# Set up daily backup at 2 AM
./scripts/setup-cron.sh daily /path/to/source /path/to/backup/dir "0 2 * * *"
```

### Version-Aware Backup
```bash
# Backup only when version changes
./scripts/backup-versioned.sh /path/to/source /path/to/version/file /path/to/backup/dir
```

### Cleanup Old Backups
```bash
# Keep only last 7 days of backups
./scripts/cleanup.sh /path/to/backup/dir 7
```

## Core Capabilities

### 1. Directory Backup
- Creates timestamped tar.gz archives
- Preserves file permissions and structure
- Excludes common temp files (node_modules, .git, etc.)

### 2. Version-Triggered Backup
- Monitors version file or command output
- Backs up only when version changes
- Useful for software updates

### 3. Scheduled Execution
- Integrates with system cron
- Supports custom schedules
- Logs execution results

### 4. Automatic Cleanup
- Deletes backups older than N days
- Keeps minimum number of backups
- Prevents disk space exhaustion

## Scripts

All scripts are in `scripts/` directory:

- `backup.sh` - Single backup execution
- `backup-versioned.sh` - Version-triggered backup
- `setup-cron.sh` - Cron job setup
- `cleanup.sh` - Old backup cleanup
- `list-backups.sh` - List available backups

## Backup Naming Convention

Backups follow