THE WORKROOM / DESKTOP MIGRATION

Move to Native Muster

This path is for Apple Silicon Macs (arm64). It uses versioned release downloads so the migration steps never depend on a mutable “latest” installer or the previous app’s update feed.

Prepare an encrypted export

Open the Muster 1.25.1 export app (download below), choose Muster → Prepare Native Muster Migration…, and save the .muster-migration file. Save the one-time recovery key separately; Muster does not retain it.

The export carries saved Composio credentials and companion preferences. Chats and workspaces stay in their existing data folder. Back up that folder separately, and expect to pair devices again.

You can export before the native app is available. Keep the encrypted archive and its recovery key private; importing starts only after native Muster 1.26.0 is published.

Checking the public versioned download…

Install native Muster

Download the native Swift app for Apple Silicon. It requires macOS 26 or newer. The button appears only after the versioned installer is reachable from this public download site.

Checking the public versioned download…

Import with a restorable backup

In native Muster’s migration settings, choose the encrypted export and recovery key, select the previous app’s data and settings folders if needed, and confirm that you have a separate restorable backup before importing.

The importer checks the source folders and records the import before applying allowlisted credentials and non-conflicting companion settings. It does not create a backup or migrate custom-profile CLI logins and other profile files.

Keep your previous Muster app until native sign-in, data access, and rollback are accepted on your Mac.

Your previous sign-in session is not migrated. You'll need to sign in to native Muster separately.

Versioned installers remain separate from the existing Intel, Windows, Linux, and automatic-update feeds. Read the release and migration notes, or return to the desktop downloads.