Skip to main content

Data & Storage

Everything about what Kognar keeps on this computer: how much space it uses, how to back it up, and how to wipe it.

Open Settings (Ctrl/Cmd+U) → Data & Storage.


Storage usage

A total figure with a breakdown bar showing how the space is divided:

ItemWhat it holds
ConversationsChat history and messages in the local database
Image cacheGenerated and attached images kept on disk
Audit logsApplication logs used for diagnostics

Backup & restore

Export All Data

Downloads a compressed backup to your Downloads folder:

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

The file contains:

  • All conversations and their messages
  • Projects, their instructions and their semantic-context preference
  • Conversation-to-project assignments
  • Your agents (built-in state and custom agents)
  • App settings

Import Backup

Select a .msgpack.gz file — or a legacy .json backup from an older version — and confirm.

warning

Importing overwrites project data, conversation assignments and agents. Existing conversations are not deleted; imported ones are merged in. Restored conversations keep their original creation and activity dates, so the sidebar groups them under the right time headings.

Backup file vs. mobile sync

This export is a file you keep yourself. It is separate from Sync with mobile, which keeps an encrypted copy in the cloud so your phone and this computer stay in step. Both can be used at the same time.


Danger zone

Clear Cache

Removes temporary index and cache data, then rebuilds it. Useful when search results look stale or incorrect. No conversations or settings are touched.

Reset Application

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

A confirmation dialog appears first. Export a backup before resetting if you might need the data later.


Where the data lives

Kognar stores data locally using a SQLite database plus an application settings file:

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