Data Portability¶
Agora stores all your data on-device and provides full import/export capabilities. You own your data — move it in, move it out, back it up.
Export¶
Export your data to a single .agora file — a portable archive that contains everything Agora stores.
What Gets Exported¶
You choose what to include:
| Category | Contents |
|---|---|
| Conversations & Messages | All chat history, message trees, branches |
| Memories | Active memory and all saved memory files |
| System Prompts | All custom system prompt templates |
| Settings | App configuration and preferences |
| API Keys | All configured API keys |
API Keys Warning
API keys are exported in plain text. Anyone with the .agora file can read your keys. Only enable API key export if you trust the destination and handle the file securely.
How to Export¶
- Go to Settings → Data Control
- Tap Export Data
- Select which categories to include
- Tap Export
- Choose where to save the
.agorafile
Import¶
Restore data from a previous .agora export.
Import Strategies¶
When importing, you choose how Agora handles data that already exists on your device:
| Strategy | Behavior |
|---|---|
| Merge | Add new items, keep existing ones. If an item with the same ID exists, the import version overwrites it. |
| Replace | Clear all existing data in the selected categories, then import. A fresh start. |
| Skip | Only import items that have no conflict. Existing items are untouched. |
Tip
Use Merge for most cases — it safely adds new data while preserving what's already on your device.
How to Import¶
- Go to Settings → Data Control
- Tap Import Data
- Select a
.agorafile - Review the import preview — see what's in the file (export date, version, content counts)
- Choose an import strategy
- Tap Import
API Keys Warning
If the export file contains API keys, Agora warns you before importing. Keys are imported in plain text. Only proceed if you trust the source of the file.
Third-Party Import¶
Import conversations from other AI chat platforms.
Import from Claude¶
Import conversations from a Claude export file:
- Export your data from Claude (Settings → Export Data)
- In Agora, go to Settings → Data Control → Third Party → Import from Claude
- Select the exported JSON file
- Review the preview — see conversation count and message count
- Choose Merge or Replace strategy
- Tap Import
Note
Agora imports conversations from Claude's JSON export format. Attachments are detected and shown in the preview. Attachments themselves are not imported — only the message text.
Import from ChatGPT¶
Import conversations from a ChatGPT export .zip file:
- Export your data from ChatGPT (Settings → Data Controls → Export)
- In Agora, go to Settings → Data Control → Third Party → Import from ChatGPT
- Select the
.zipfile - Review the preview
- Choose Merge or Replace strategy
- Tap Import
Note
Both user and assistant messages are imported. Message roles are preserved.
File Format¶
The .agora file is a JSON-based archive. If you're technically inclined, you can inspect or process it with standard tools. The format is designed for forward and backward compatibility.
Auto Backup¶
Agora can automatically back up your data on a schedule. You don't need to remember to export — Agora handles it for you.
How It Works¶
- Auto backup runs periodically in the background using Android WorkManager
- When a backup is due, Agora exports all your data (except API keys) to the configured directory
- A notification appears only if a backup fails — successful backups are silent
- Old backups are automatically deleted based on your retention settings
Configuration¶
- Go to Settings → Data Control → Auto Backup
- Toggle Auto Backup on/off
- Set Backup every — choose 1 day, 3 days, 5 days, 1 week, or 1 month
- Choose Export content — select which categories to include (API keys are excluded from auto backup)
- Set Backup location — tap to pick a folder (defaults to
Download/Agora/Backup) - Toggle Auto delete old backups on/off, and set Delete older than period
Auto Delete Constraint
The delete period must be longer than the backup period. For example, if you back up every week, backups can be auto-deleted after 1 month or 1 year — never sooner. This prevents deleting your only backup before a new one is created.
Note
Auto backup uses Android's WorkManager to ensure reliability even if the app is closed or the device restarts. Backups may be slightly delayed during Doze mode to conserve battery.
Best Practices¶
- Export regularly as a backup — keep the file somewhere safe
- Enable Auto Backup for hands-off scheduled protection
- Don't include API keys in routine exports — enable key export only for full device migrations
- Use Merge for incremental imports — Replace is destructive
- Preview before importing — check the export date and content counts to confirm it's the right file