Skip to main content

​
The Preferred In-App Upgrade Path

Starting with Alpha 3, the easiest way to check for and install updates is directly within the desktop application interface. As outlined in the Desktop App Overview, clicking your user profile tray in the bottom-left corner and selecting About MemoryBox launches the platform’s diagnostic integrity card. Clicking the Check for updates button on that modal automatically pings our secure distribution network. If a newer stable build is available, the system will prompt you to download and initialize the installation immediately.

​
Manual “Safe-Swap” Upgrades

Because MemoryBox enforces a strict local-first architecture, your Knowledge Base (the SQLite database and vector search directories containing your memories) is stored completely separate from the execution binaries. This design ensures you can safely swap, overwrite, or reinstall the software files while leaving your saved data completely untouched.
Pre-upgrade Requirement: Always ensure the MemoryBox daemon and app windows are fully closed before initiating a manual update.
1

Quit MemoryBox

Ensure the application processes are terminated. Check your top system Menu Bar for the floating MemoryBox icon, click it, and select Quit.
2

Remove Legacy Version

Navigate to your Applications directory and drag the old MemoryBox app icon into the Trash. (Note: Your local library path containing your indexed knowledge base remains untouched).
3

Install Target Build

Download the updated .dmg image file from your authorization link, mount it, and drag the fresh version directly into your Applications folder.
4

Initialize and Launch

Launch the new application build. MemoryBox will automatically detect your existing Personas, localized Memory Spaces, and historical chat assets on startup.
1

Download the Bundle

Download the updated production extension directory bundle from your platform invitation access link and unpack the zip folder.
2

Overwrite Local Files

Locate your existing extension development folder on your computer and overwrite its contents with the newly extracted asset files.
3

Reload the Extension

Navigate your browser tab to chrome://extensions and click the circular Refresh icon on your pinned MemoryBox extension card to apply the update.