Clawdbot Sync

---
name: clawdbot-sync
version: 1.0.0
description: "Synchronize memory, preferences, and skills between multiple Clawdbot instances. Supports bi-directional sync via SSH/rsync over Tailscale. Use when asked to sync with another Clawdbot, share memory between instances, or keep multiple agents in sync. Triggers: /sync, 'sync with mac', 'update other clawdbot', 'share this with my other bot'."
author: clawdbot
license: MIT
metadata:
  clawdbot:
    emoji: "🔄"
    triggers: ["/sync"]
    requires:
      bins: ["rsync", "ssh", "jq"]
  tags: ["sync", "multi-agent", "collaboration", "backup"]
---

# Clawdbot Sync 🔄

Synchronize memory, preferences, and skills between multiple Clawdbot instances over Tailscale/SSH.

## Features

- **Bi-directional sync** between Clawdbot instances
- **Smart conflict resolution** (newest wins, or merge for logs)
- **Selective sync** — choose what to sync
- **Peer discovery** via Tailscale
- **Dry-run mode** for preview

## Commands

| Command | Action |
|---------|--------|
| `/sync` | Show status and configured peers |
| `/sync status` | Check connection to all peers |
| `/sync now [peer]` | Sync with peer (or all) |
| `/sync push [peer]` | Push local changes to peer |
| `/sync pull [peer]` | Pull changes from peer |
| `/sync add <name> <host> [user] [path]` | Add a peer |
| `/sync remove <name>` | Remove a peer |
| `/sync diff [peer]` | Show what would change |
| `/sync history` | Show sync history |

## Setup

### 1. Configure Peers

```bash
handler.sh add mac-mini 100.95.193.55 clawdbot /Users/clawdbot/clawd $WORKSPACE
handler.sh add server 100.89.48.26 clawdbot /home/clawdbot/clawd $WORKSPACE
```

### 2. Ensure SSH Access

Both machines need SSH key auth:
```bash
ssh-copy-id clawdbot@100.95.193.55
```

### 3. Test Connection

```bash
handler.sh status $WORKSPACE
```

## What Gets Synced

| Item | Default | Notes |
|------|---------|-------|
| `memory/` | ✅ Yes | All memory files and skill data |
| `MEMORY.md` | ✅ Yes | Main memory file |
| `USER.md` | ✅ Yes | User profile |
| `IDENTITY.md` | ❌ No | Each instance has its own identity |
| `skills/` | ⚙️ Optional | Installed skills |
| `config/` | ❌ No | Instance-specific config |

## Handler Commands

```bash
handler.sh status $WORKSPACE                    # Check peers and connection
handler.sh sync <peer> $WORKSPACE               # Bi-directional sync
handler.sh push <peer> $WORKSPACE               # Push to peer
handler.sh pull <peer> $WORKSPACE               # Pull from peer
handler.sh diff <peer> $WORKSPACE               # Show differences
handler.sh add <name> <host> <user> <path> $WS  # Add peer
handler.sh remove <name> $WORKSPACE             # Remove peer
handler.sh history $WORKSPACE                   # Sync history
handler.sh auto <on|off> $WORKSPACE             # Auto-sync on heartbeat
```

## Conflict Resolution

1. **Timestamp-based**: Newer file wins
2. **Merge for logs**: Append-only files are merged
3. **Skip conflicts**: Option to skip conflicting files
4. **Manual resolution**: Flag for review

## Data Files

Stored in `$WORKSPACE/memory/clawdbot-sync/`:

| File | Purpose |
|------|---------|
| `peers.json` | Configured peers |
| `history.json` | Sync history log |
| `config.json` | Sync preferences |
| `conflicts/` | Conflicting files for review |

## Example Session

```
User: /sync now mac-mini
Bot: 🔄 Syncing with mac-mini (100.95.193.55)...

     📤 Pushing: 3 files changed
     • memory/streaming-buddy/preferences.json
     • memory/2026-01-26.md
     • MEMORY.md
     
     📥 Pulling: 1 file changed
     • memory/2026-01-25.md
     
     ✅ Sync complete! 4 files synchronized.
```

## Requirements

- `rsync` (for efficient file sync)
- `ssh` (for secure transport)
- Tailscale or direct network access between peers
- SSH key authentication configured

## Security

- Uses SSH for all transfers (encrypted)
- No passwords stored (key-based auth only)
- Sync paths are restricted to workspace
- No system files are ever synced