workspace-git-backup

# GitHub Backup

Automatic scheduled backup of any directory to a remote Git repository.

## Setup Flow

When user asks for backup setup, follow these steps:

### 1. Ask for backup directory

Default: `~/.openclaw/workspace`

### 2. Configure remote repository

**If GitHub CLI (`gh`) is available and authenticated:**

Ask user:
- "新建 GitHub 仓库 还是 同步到已有仓库？"

**New repo:**
```bash
gh repo create <name> --private --source=<backup-path> --remote=origin
```

**Existing repo:**
```bash
# List repos
gh repo list --limit 50

# Add remote (user provides repo name or URL)
git -C <backup-path> remote add origin <url>
```

**If no GitHub CLI:**
- Ask user for repository URL directly

### 3. Create config file

```bash
cat > ~/.openclaw/workspace/.backup-config.json << 'EOF'
{
  "backupPath": "<backup-path>",
  "gitRemote": "<repo-url>",
  "schedule": "0 12,0 * * *",
  "updateTimestamp": true
}
EOF
```

### 4. Install backup script

```bash
mkdir -p ~/.openclaw/scripts
cp <skill-path>/scripts/backup.sh ~/.openclaw/scripts/github-backup.sh
chmod +x ~/.openclaw/scripts/github-backup.sh
```

### 5. Install scheduled task

**macOS (launchd):**
```bash
bash <skill-path>/scripts/install-launchd.sh
```

**Linux (cron):**
```bash
bash <skill-path>/scripts/install-cron.sh
```

### 6. Optional: First backup

```bash
bash ~/.openclaw/scripts/github-backup.sh
```

## Commands

After setup, user can:

| Command | Action |
|---------|--------|
| `bash ~/.openclaw/scripts/github-backup.sh` | Manual backup |
| `bash <skill-path>/scripts/manage.sh status` | Check status |
| `bash <skill-path>/scripts/manage.sh logs` | View logs |
| `bash <skill-path>/scripts/manage.sh uninstall` | Remove scheduled task |

## Configuration

Config: `~/.openclaw/workspace/.backup-config.json`

| Field | Default | Description |
|-------|---------|-------------|
| `backupPath` | `~/.openclaw/workspace` | Directory to backup |
| `gitRemote` | required | Repository URL |
| `schedule` | `0 12,0 * * *` | C...