101 lines
2.1 KiB
Markdown
101 lines
2.1 KiB
Markdown
---
|
|
name: workspace-sync
|
|
description: Sync agent workspace with cloud storage (Dropbox, Google Drive, S3, etc.) using rclone.
|
|
metadata: {"moltbot":{"emoji":"☁️","requires":{"bins":["rclone"]}}}
|
|
---
|
|
|
|
# workspace-sync
|
|
|
|
Bidirectional sync between the agent workspace and cloud storage. Useful for backing up workspace files, sharing across devices, or restoring after migrations.
|
|
|
|
## Trigger
|
|
|
|
Use this skill when the user asks to:
|
|
- Sync workspace to/from cloud
|
|
- Back up workspace files
|
|
- Check sync status
|
|
- Fix sync issues
|
|
|
|
## Commands
|
|
|
|
### Check sync status
|
|
```bash
|
|
moltbot workspace status
|
|
```
|
|
|
|
Shows: provider, last sync time, sync count, error count, running state.
|
|
|
|
### Trigger manual sync
|
|
```bash
|
|
moltbot workspace sync
|
|
```
|
|
|
|
Runs a bidirectional sync immediately. Use after bulk workspace changes.
|
|
|
|
### First-time sync (required once)
|
|
```bash
|
|
moltbot workspace sync --resync
|
|
```
|
|
|
|
Required on first run to establish baseline. Only needed once per remote.
|
|
|
|
### View remote files
|
|
```bash
|
|
moltbot workspace list
|
|
```
|
|
|
|
Lists files in the configured cloud storage path.
|
|
|
|
## Configuration
|
|
|
|
Workspace sync is configured in `moltbot.json`:
|
|
|
|
```json
|
|
{
|
|
"workspace": {
|
|
"sync": {
|
|
"provider": "dropbox",
|
|
"remotePath": "/",
|
|
"localPath": "/",
|
|
"interval": 60,
|
|
"onSessionStart": true,
|
|
"onSessionEnd": true
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Automatic sync
|
|
|
|
When configured, sync runs automatically:
|
|
- **On session start**: Before you start working (pulls latest from cloud)
|
|
- **On session end**: After conversation ends (pushes changes to cloud)
|
|
- **Periodic interval**: Background sync every N seconds (no LLM cost)
|
|
|
|
## Troubleshooting
|
|
|
|
### "rclone not configured"
|
|
Run the setup wizard:
|
|
```bash
|
|
moltbot workspace setup
|
|
```
|
|
|
|
### "requires --resync"
|
|
First sync needs to establish baseline:
|
|
```bash
|
|
moltbot workspace sync --resync
|
|
```
|
|
|
|
### Check rclone directly
|
|
```bash
|
|
rclone lsd cloud:/
|
|
rclone ls cloud:moltbot-share
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Sync is bidirectional (changes flow both ways)
|
|
- Conflicts resolve by newest file (configurable)
|
|
- `.git/` and `node_modules/` excluded by default
|
|
- Sync operations run in background (no LLM tokens used)
|