App Crashes & Recovery

Your Data Is Safe

If CodeMantis crashes unexpectedly, your work is not lost. There are two important things to understand about how data is handled:

• Your project files are unchanged. CodeMantis (and Claude Code) writes changes directly to your filesystem in real time. Any file modifications that completed before the crash are already saved to disk. There is no "unsaved changes" risk.
• Session history is preserved server-side. Your conversation history with Claude is stored on Anthropic's servers. When you reopen a project after a crash, previous sessions remain accessible.

How to Recover

1. Relaunch CodeMantis

Simply open CodeMantis again from your Applications folder. The app will restore your workspace and project tabs automatically.

2. Resume your session

Open the project you were working on. You can start a new session and continue where you left off. If you need to reference what Claude did before the crash, your session history is available in the session list.

3. Check your files

Open your project in Finder or your code editor to verify the state of your files. Since Claude Code writes changes directly to disk, your codebase will reflect every change that completed before the crash.

Where Data Is Stored

CodeMantis stores its application data in the standard macOS application support directory:

~/Library/Application Support/dev.codemantis.app/

This directory contains:

• Local database — Project metadata, preferences, and session references.
• Configuration files — Your settings, theme selection, and API keys for AI assistants.
• Logs — Diagnostic information that can help troubleshoot crashes.

You should not need to modify anything in this directory manually, but knowing its location is helpful if you need to back up your settings or provide diagnostic data when reporting a bug.

Reporting Crashes

If CodeMantis crashes repeatedly, please report the issue so it can be fixed:

1. Go to the CodeMantis GitHub Issues page.
2. Create a new issue with the title "App crash" and describe what you were doing when the crash occurred.
3. Include your macOS version, CodeMantis version (visible in Settings), and any relevant log output from ~/Library/Application Support/dev.codemantis.app/.

Crash reports help the development team identify and fix stability issues for everyone.