Data Backup & Restore

Kognar Chat stores all your conversations, projects, and settings locally on your device. You can export a backup at any time to keep your data safe or transfer it to another machine.

There are two independent mechanisms:

	Backup file	Mobile sync
What it is	A file you export and keep yourself	An encrypted copy in the cloud
Where	Settings → Data & Storage	Settings → Sync with mobile
Used for	Archiving, moving to another computer	Keeping this computer and your phone in step

This page covers the backup file. For the phone pairing, see Sync with Mobile.

---

Exporting a backup

1. Open Settings (Ctrl/Cmd+U)
2. Go to Data & Storage
3. Click Export All Data

A compressed backup file is saved to your Downloads folder:

kognar-backup-YYYY-MM-DD.msgpack.gz

The backup includes:

• All conversations and their messages, with rendered component data (charts, tables, etc.)
• Project names, per-project instructions and their semantic-context preference
• Conversation-to-project assignments
• Your agents — built-in state and custom agents
• App settings

---

Importing a backup

1. Open Settings → Data & Storage
2. Click Import Backup
3. Select a .msgpack.gz file (or a legacy .json backup if migrating from an older version)
4. Confirm the import

warning

Importing overwrites your current project data, conversation assignments and agents. Existing conversations are not deleted — they are merged with the imported data. Restored conversations keep their original creation and activity dates, so the sidebar's time groupings stay correct.

---

Resetting the app

If you want to wipe everything and start fresh:

1. Open Settings → Data & Storage → Danger zone
2. Click Reset Application
3. Read the warning and confirm

danger

Reset is permanent and irreversible. It deletes:

• All conversation history and messages
• All settings and preferences
• All projects and project instructions
• All custom agents and rules
• All local cache and index data

There is no undo. Export a backup first if you might need your data later.

---

Clearing the cache

The search index and UI cache can become stale in rare cases. To rebuild them:

1. Open Settings → Data & Storage → Danger zone
2. Click Clear Cache

This only removes temporary index data — no conversations or settings are affected.

---

Storage location

Kognar stores data locally on your device using a SQLite database and an Electron settings file. The exact location depends on your operating system:

Platform	Location
macOS	~/Library/Application Support/kognar-chat-client/
Windows	%APPDATA%\kognar-chat-client\
Linux	~/.config/kognar-chat-client/