Backup & Restore

Export and import agent workspaces to protect your data and move between machines.

Overview

Your agent's workspace contains everything that makes it unique - personality files (SOUL.md), memory (MEMORY.md, daily notes), instructions (AGENTS.md), and configuration. The Backup Manager lets you export all of this as a zip file and restore it later.

Exporting

Export creates a .zip file containing your agent's workspace files. This includes:

• SOUL.md, USER.md, AGENTS.md, IDENTITY.md, TOOLS.md
• MEMORY.md and daily memory files
• HEARTBEAT.md and other workspace files
• Custom skills and local configurations

The export shows the agent name and emoji so you can easily identify which backup belongs to which agent.

Restoring

Import a previously exported zip file to restore an agent's workspace. This is useful for migrating agents between machines, recovering from data loss, or setting up a new installation with an existing agent configuration.

Session Management

In Settings → Preferences, you'll find session management options including:

• Session Condense - Compact old sessions to reduce storage and context overhead
• Auto-Condense - Schedule automatic session condensing at regular intervals
• Manual Condense - Trigger condensing on demand for specific sessions

Next Steps

Secure your setup with Security settings, or check Troubleshooting if you run into issues.