Skip to main content

Update on a Mac

From version 2.2.1, the Mac app is signed with an Apple Developer ID and notarized by Apple. Version 2.2.0 and earlier were not: they cannot update themselves, and when a new version is out they open the release page.

You can update in two ways. Your coding agent can do it for you, or you can do it by hand.

The one step that is always yours​

After every update, macOS asks:

« Mnemosyne OS » wants to use your confidential information stored in « @mnemosyne-workspace/infinity-edition Safe Storage ».

Click Always Allow. Your API keys open as before.

From 2.2.1, macOS asks once, the first time you open the signed app. It does not ask again at the following updates. Versions before 2.2.1 had a new signature at each build, so the question came back at each update.

If you click Deny, nothing is lost. The app uses the copy of your keys it keeps on this Mac for that session, and macOS asks again at the next launch.

Ask your coding agent​

If you use Claude Code, Cursor or another agent with the Mnemosyne OS MCP server, ask it:

Update Mnemosyne OS on this Mac.

The agent uses two tools:

  1. mnemosyne_mac_update_check reads the installed version and the latest release. It writes nothing. The agent shows you what it found.
  2. mnemosyne_mac_update_install runs once you agree. It:
    • downloads the new version and checks its fingerprint against the release;
    • copies your key files to ~/.mnemosyne/update-backups/;
    • asks the app to quit, and waits (it never forces it);
    • checks the new app's signature, then puts it in place of the old one;
    • keeps the old app in the backup folder;
    • starts the new version.

Then macOS asks for Keychain access: click Always Allow. The agent never answers that dialog for you.

By hand​

  1. Download the .dmg from the release page the app opened.
  2. Quit Mnemosyne OS (Cmd+Q).
  3. Open the .dmg and drag MnemosyneOS into Applications. Replace the old one.
  4. Open Mnemosyne OS. With a version before 2.2.1, right-click the app the first time, then Open.
  5. When macOS asks for Keychain access, click Always Allow.

Going back​

An update made by the agent keeps the previous app in ~/.mnemosyne/update-backups/<date>/. Put it back in Applications to return to it.