Migrate a Grok Bot Agent to Suparagent: Export and Import Guide

What a Grok Bot migration transfers

The migration copies an agent’s name, title, description and standing instructions. On the local app, JSON manifests can also include optional notes and text-only skills; compatible ZIP exports can include memory facts, standalone Markdown skills and a full persona file. Notes require opt-in, and imported skills start disabled. Each profile becomes a new agent on Ask first, with the default model and its own folder.

Credentials, connected accounts, conversations, routines, tools, executable skills, arbitrary files, avatars, rooms and channels are not transferred. Review the export and remove sensitive details before importing it.

1. Create a Grok Bot export

1. In Suparagent, open Agents and choose Migrate… .
2. Select Grok Bot export and copy the prompt shown in the panel.
3. Paste the prompt into the Grok Bot conversation for the agent you want to move. Ask it to return only the requested JSON. The local app requests a versioned manifest; hosted accounts use a basic single-agent JSON export.

2. Preview and import the Grok Bot agent

1. In the local app, paste the versioned JSON from the prompt or choose its JSON file. You can also choose a compatible version 1 ZIP profile package with a root JSON profile list. The preview can show up to 20 profiles; import one profile at a time.
2. Review the name, title, description, instructions, skipped fields and any redactions. Opt in if you want to copy notes. Standalone text-only skills can be reviewed and imported disabled; skills that need extra files are skipped.
3. Choose Review profile, then import the profile to create a fresh agent. Hosted accounts can paste the basic single-agent JSON reply; profile manifests and ZIP packages are local-app features.

3. Finish setting up the migrated agent

Choose an available engine and sign in separately. Reconnect any services and recreate tools, routines, files or other workspace state yourself. Review each permission before using the agent for consequential work.

The importer reads supported profile fields from a JSON or ZIP export. It does not connect to Grok Bot, fetch a share link or scan a source workspace.

Questions, answered