Updating CodeMantis
How CodeMantis updates work and how to install new versions.
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
- 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.
- One-click install. Click the update button in the notification. CodeMantis will download the new version in the background.
- 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, download the latest build and reinstall over the top. These links always point to the current version (you can also use the download page):
macOS — Download the latest .dmg, open it, and drag CodeMantis into your Applications folder, replacing the existing version. Then launch the updated app.
Windows — Download the latest .exe installer (or the .msi for managed installs) and run it. It updates your existing installation in place.
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 the changelog 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, uninstall CodeMantis (drag it from Applications to the Trash on macOS, or remove it via Settings → Apps on Windows), download the latest installer from the download page, and install fresh. Your data is preserved separately from the application binary — on macOS in
~/Library/Application Support/dev.codemantis.app/, and on Windows in%APPDATA%\dev.codemantis.app\.