/Data Export & Import
Features

Data Export & Import

Exporting, importing, and migrating your OpenHelm data.

Exporting Data

Export all your OpenHelm data to a portable JSON file via Settings → Export Data.

The export includes:

  • Projects, goals, jobs
  • Run history (and optionally, full run logs)
  • Inbox items and conversations
  • Memory store
  • Settings (excluding machine-specific paths like the Claude Code binary location)

Importing Data

Import a previously exported JSON file via Settings → Import Data.

Preview before import: OpenHelm shows you what the file contains — record counts, export date, and app version — before making any changes.

Important: Import is a full replacement. All existing data is overwritten with the imported data. This cannot be undone. The import is also blocked if there are any active or queued runs.

After import, machine-specific settings (like the Claude Code path) are automatically preserved from your current installation rather than overwritten.

Migrating Between Machines

  1. On your old Mac: Settings → Export Data
  2. Transfer the export file to your new Mac (AirDrop, iCloud, USB, etc.)
  3. Install OpenHelm on the new Mac
  4. Settings → Import Data and select the file
  5. If your project directories are in different locations on the new Mac, use Settings → Fix Project Paths to update them

What's Not Included

  • Claude Code itself and its authentication state (must be set up separately on the new Mac)
  • The Claude Code binary path setting (re-detected automatically after import)