Skip to main content

Backup Plugin

The backup plugin (@vibecontrols/vibe-plugin-agent-backup) snapshots agent + vibe state on a schedule and restores from snapshots on demand.

What it backs up​

  • Per-vibe metadata (the local copy of vibe records the agent has cached)
  • Vibe working trees (configurable include/exclude patterns)
  • Database dumps for postgres / mysql services declared in the vibe
  • Notes content
  • Agent configuration (excluding secrets — those need a separate flow)

Backends​

Backends are pluggable. The plugin ships with:

BackendUse for
s3Cloud storage (your AWS account)
filesystemLocal or NFS-mounted path
customImplement your own BackupBackend

Configure in ~/.boff/vibecontrols/agents/<id>/config.json:

{
  "plugins": {
    "backup": {
      "backend": "s3",
      "schedule": "0 2 * * *",
      "retentionDays": 30,
      "config": {
        "bucket": "my-vibe-backups",
        "region": "us-west-2",
        "prefix": "agents/"
      }
    }
  }
}

Trigger a backup manually​

vibecontrols backup create --agent <agent-id>

Restore​

vibecontrols backup list --agent <agent-id>
vibecontrols backup restore <backup-id>

Source​

~/products/vibecontrols/vibe-plugin-agent-backup/

Next steps​