Updating CodeMantis

How Updates Work

CodeMantis includes a built-in auto-update system. When a new version is available, you will see a notification inside the app prompting you to update. The process is designed to be simple and non-disruptive.

Auto-Update Process

1. Notification appears. When CodeMantis detects a new release, a notification banner appears in the app. This check happens automatically when you launch the app and periodically while it is running.
2. One-click install. Click the update button in the notification. CodeMantis will download the new version in the background.
3. Restart to apply. Once the download is complete, you will be prompted to restart the app. The update is applied during the restart — it takes just a few seconds.

Manual Update

If you prefer to update manually, or if the auto-update notification does not appear:

1. Visit the CodeMantis GitHub Releases page.
2. Download the latest .dmg file for your Mac architecture (Apple Silicon or Intel).
3. Open the .dmg and drag CodeMantis into your Applications folder, replacing the existing version.
4. Launch the updated app.

What Happens to Your Data

Updates are designed to preserve all of your data:

• Settings and preferences are retained across updates. Your theme, API keys, keyboard shortcuts, and all other configuration remain exactly as you set them.
• Project history is preserved. Your session history and project references carry over to the new version.
• Database migrations run automatically. If a new version changes the internal data schema, CodeMantis runs the necessary migrations on first launch. This happens silently in the background — no action is required on your part.

Checking Your Current Version

To see which version of CodeMantis you are running, open Settings (Command + ,). Your version number is displayed at the bottom of the settings panel. Compare this to the latest release on GitHub to determine if an update is available.

Troubleshooting Updates

If an update fails to install:

• Ensure you have enough free disk space for the download.
• Check that your internet connection is stable.
• Try the manual download method described above as a fallback.
• If the app does not launch after an update, delete CodeMantis from Applications, re-download the latest .dmg from GitHub Releases, and install fresh. Your data in ~/Library/Application Support/dev.codemantis.app/ is preserved separately from the application binary.