AI Agent Hub
Back to skills
WorkBuddy Data Migration Assistant icon

WorkBuddy Data Migration Assistant

IT Ops & Security Updated 2026.08.30

Paste the following prompt into your AI chat to install this skill:

Please follow https://skillhub.cn/install/skillhub.md to install @user_a4bd4246/workbuddymigrate.

About this skill

The Problem

WorkBuddy data is spread across workbuddy.db, skills/, projects/, connectors/, and related state directories. When users switch accounts, devices, or operating systems, raw copies can leave sessions.cwd paths invalid, user_id values inconsistent, and project directory names mismatched with the new cwd encoding. Manual migration can also miss SQLite WAL data, overwrite existing records, or break task-session links.

How It Works

The skill structures migration as a previewable, verifiable workflow:
- Scan current data: Identify databases, Skills, project history, connectors, active sessions, tasks, and team configuration.
- Create a backup: Package core data modules and back up the target database before restore.
- Cross-platform mapping: For macOS to Windows migrations, reconcile paths, user_id, workspaces.path, project directory names, and missing directories.
- Smart restore: Apply INSERT OR IGNORE to database rows, merge Skills by name, merge project directories, and create config files only when absent.
- Post-restore validation: Check sessions.cwd validity, workspace directories, project matching, task-session links, and user_id consistency.

Boundaries and Notes

This skill fits same-machine account changes, cross-device migration, and repair of imported data with incorrect paths. binaries/, app/, and plugins/ are not backed up by default. Restore is non-overwriting by default; use --auto-map for cross-platform migration and run it while WorkBuddy is not actively writing to reduce database conflicts.

Use Cases

  • Migrate WorkBuddy across devices by mapping paths, merging accounts, and validating task-session links
  • Restore tasks, Skills, and connectors from an old account without overwriting the new account
  • Back up WorkBuddy configuration and project history before reinstalling or switching accounts
  • Repair imported records with invalid sessions.cwd values and remap project directories

Best For

  • Engineers maintaining personal WorkBuddy workflows need tasks, Skills, and connectors preserved after moving machines
  • Developers who switch accounts often need old-account sessions restored without overwriting new-account data
  • Ops engineers working across macOS and Windows need path-encoding issues repaired so tasks remain usable
  • IT administrators archiving team WorkBuddy configuration need tasks, project history, and team structure backed up