---
title: "Import & Export"
description: "Export an agent's configuration as a JSON file and import it into any other agent."
---

## What gets exported

The export captures the full agent configuration:

- **Persona** - the starter persona slug (if one was picked in the wizard)
- **Description** - the one-line description shown to boss agents
- **CLAUDE.md** - identity, instructions, and behavior rules
- **Skills** - all Markdown skill files (category, filename, content, sort order)

Slack credentials, memories, wiki content, and scheduled jobs are **not** included. This keeps exports portable - you can import a config into any agent without overwriting live credentials, ingested wiki, or accumulated memory.

---

## Exporting an agent

1. Open the agent in the dashboard
2. Click the **Download** icon in the top-right of the agent page
3. A JSON file named `{agent-slug}-export.json` downloads immediately

The file looks like:

```json
{
  "persona": "data-analyst",
  "description": "Answers questions about product metrics and builds ad-hoc SQL.",
  "claudeMd": "# DataBot\n\nYou are a data analyst...",
  "skills": [
    {
      "category": "sql",
      "filename": "sql-rules.md",
      "content": "## SQL Rules\n...",
      "sortOrder": 0
    }
  ]
}
```

---

## Importing a config

Import applies an exported config to an **existing** agent - it overwrites that agent's CLAUDE.md and upserts its skills. Persona and description are applied if present in the export.

1. Open the target agent in the dashboard
2. Click the **Upload** icon in the top-right
3. Select the `.json` export file
4. A confirmation modal shows what will be applied:
   - Persona and description (if present)
   - The new CLAUDE.md content
   - How many skills will be upserted
5. Click **Apply Import** to confirm

<Note>
  Import **overwrites** the agent's current CLAUDE.md. Skills are upserted - existing skills with the same name are updated, new ones are added, and skills not in the import are left untouched.
</Note>

---

## Common use cases

| Use case | How |
|----------|-----|
| **Clone an agent** | Export agent A → create agent B → import into B |
| **Promote staging → prod** | Export from a test agent, import into the live one |
| **Backup before a big edit** | Export before making large changes to CLAUDE.md |
| **Share agent templates** | Export and send the JSON to a teammate to import |
| **Roll back instructions** | Use [Version History](/features/history) for full snapshots, or re-import an old export |

---

## Next steps

<CardGroup cols={2}>
  <Card title="Version History" icon="clock-rotate-left" href="/features/history">
    Auto-snapshots on every save - browse diffs and restore any version.
  </Card>
  <Card title="Creating Agents" icon="robot" href="/agents/creating-agents">
    Set up a new agent to import a config into.
  </Card>
</CardGroup>
