Compatibility
Learn about the AI tools, operating systems, and version requirements supported by Mantra to ensure your environment can run Mantra properly.
Version Updates
This page is updated with Mantra releases. We recommend using the latest version for best compatibility.
Supported AI Tools
Mantra currently supports importing and analyzing conversation logs from the following AI programming tools.
Claude Code
| Version | Support Status | Notes |
|---|---|---|
| 1.0.0+ | ✅ Full support | Recommend using latest version |
Supported features:
- ✅ Conversation log import
- ✅ Time Travel (code snapshots)
- ✅ Message filtering
- ✅ Content redaction
- ✅ Tool call viewing
- ✅ Code block highlighting
- ✅ File tree browsing
Log location:
- macOS/Linux:
~/.claude/projects/ - Windows:
%USERPROFILE%\.claude\projects\
Gemini CLI
| Version | Support Status | Notes |
|---|---|---|
| 1.0.0+ | ✅ Full support | Recommend using latest version |
Supported features:
- ✅ Conversation log import
- ✅ Time Travel (code snapshots)
- ✅ Message filtering
- ✅ Content redaction
- ⚠️ Tool call viewing (partial support)
- ✅ Code block highlighting
- ✅ File tree browsing
Log location:
- macOS/Linux:
~/.gemini/ - Windows:
%USERPROFILE%\.gemini\
Gemini CLI Tool Calls
Some older versions of Gemini CLI log formats may not include complete tool call information. We recommend updating to the latest version for full support.
Cursor
| Version | Support Status | Notes |
|---|---|---|
| 0.40.0+ | ✅ Full support | Recommend using latest version |
| 0.35.0 - 0.39.x | ⚠️ Partial support | Some features may be limited |
| < 0.35.0 | ❌ Not supported | Incompatible log format |
Supported features:
- ✅ Conversation log import
- ✅ Time Travel (code snapshots)
- ✅ Message filtering
- ✅ Content redaction
- ✅ Tool call viewing
- ✅ Code block highlighting
- ✅ File tree browsing
Log location:
- macOS:
~/Library/Application Support/Cursor/User/workspaceStorage/ - Windows:
%APPDATA%\Cursor\User\workspaceStorage\ - Linux:
~/.config/Cursor/User/workspaceStorage/
Codex
| Version | Support Status | Notes |
|---|---|---|
| 1.0.0+ | ✅ Full support | Recommend using latest version |
Supported features:
- ✅ Conversation log import
- ✅ Time Travel (code snapshots)
- ✅ Message filtering
- ✅ Content redaction
- ✅ Tool call viewing
- ✅ Code block highlighting
- ✅ File tree browsing
Log location:
- macOS/Linux:
~/.codex/ - Windows:
%USERPROFILE%\.codex\
Antigravity
| Version | Support Status | Notes |
|---|---|---|
| - | 🔜 Coming soon | Stay tuned |
Feature Support Matrix
The following table shows Mantra feature support across AI tools:
| Feature | Claude Code | Gemini CLI | Cursor | Codex | Antigravity |
|---|---|---|---|---|---|
| Conversation import | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Time Travel | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Code snapshots | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Message filtering | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Content redaction | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Tool call viewing | ✅ | ⚠️ | ✅ | ✅ | 🔜 |
| Code block highlighting | ✅ | ✅ | ✅ | ✅ | 🔜 |
| File tree browsing | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Git history matching | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Real-time sync | ✅ | ✅ | ✅ | ✅ | 🔜 |
Legend: ✅ Full support | ⚠️ Partial support | 🔜 Coming soon | ❌ Not supported
Operating System Requirements
macOS
| Requirement | Specification |
|---|---|
| Minimum version | macOS 12.0 (Monterey) |
| Recommended version | macOS 13.0+ (Ventura or higher) |
| Architecture support | Native support for Intel and Apple Silicon |
| Disk space | At least 500MB free space |
| Memory requirement | Minimum 4GB, recommended 8GB+ |
Apple Silicon Optimization
Mantra is optimized for Apple Silicon chips. M1/M2/M3 series chip users will get the best performance experience.
Windows
| Requirement | Specification |
|---|---|
| Minimum version | Windows 10 (version 1903+) |
| Recommended version | Windows 11 |
| Architecture support | x64 (64-bit) |
| Disk space | At least 500MB free space |
| Memory requirement | Minimum 4GB, recommended 8GB+ |
Windows 7/8 Not Supported
Due to technical limitations, Mantra does not support Windows 7 and Windows 8/8.1. Please upgrade to Windows 10 or higher.
Linux
| Requirement | Specification |
|---|---|
| Distribution support | Ubuntu 20.04+, Fedora 35+, Debian 11+ |
| Architecture support | x64 (64-bit) |
| Disk space | At least 500MB free space |
| Memory requirement | Minimum 4GB, recommended 8GB+ |
Supported distributions:
- Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS
- Fedora 35, 36, 37, 38, 39
- Debian 11 (Bullseye), 12 (Bookworm)
- Linux Mint 20+
- Arch Linux (requires AUR)
Dependency requirements:
# Debian/Ubuntu
sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6
# Fedora
sudo dnf install gtk3 libnotify nss libXScrnSaver libXtstSystem Resource Recommendations
Based on your usage scenario, here are recommended system configurations:
| Usage Scenario | Memory | Disk Space | Description |
|---|---|---|---|
| Light use | 4GB | 500MB | Few projects, occasional use |
| Daily use | 8GB | 1GB | Multiple projects, frequent use |
| Heavy use | 16GB+ | 2GB+ | Many projects, large conversations |
Performance Tips
- Using an SSD significantly improves project loading speed
- Closing unused projects reduces memory usage
- Clearing cache periodically frees disk space
Known Limitations
Claude Code Limitations
- Very early versions (beta test versions) log formats may be incompatible
- Some custom-configured log paths need to be specified manually
- Encrypted log files cannot be imported
Gemini CLI Limitations
- Versions before 1.0.0 have incompatible log formats
- Some tool call information may be incomplete
- Offline mode conversations may lack timestamps
Cursor Limitations
- Versions before 0.35.0 have incompatible log formats
- Composer mode conversations require version 0.40.0+
- Some plugin-generated conversations may not parse correctly
General Limitations
| Limitation | Description | Recommendation |
|---|---|---|
| Messages per project | Performance may be affected over 5000 | View by time period |
| Single message size | Loading may be slow over 1MB | Normal use won't encounter this |
| Concurrent projects | Recommend no more than 10 open simultaneously | Close unused projects |
| Git repository size | Very large repos (>5GB) matching may be slow | Wait patiently or use shallow clone |
Coming Soon
We're actively developing the following features and support:
More AI Tools
| Tool | Status | Expected Timing |
|---|---|---|
| Windsurf | 🔜 In development | Coming soon |
| Codeium | 📋 Planned | TBD |
| GitHub Copilot | 📋 Planned | TBD |
Feature Enhancements
- 🔜 Team Collaboration: Multi-user shared project analysis
- 🔜 Cloud Sync: Cross-device data synchronization
- 🔜 AI Analysis Reports: Automatic code quality report generation
- 📋 Plugin System: Community extension support
Feature Requests
If you'd like Mantra to support other AI tools or features, feel free to submit a feature request on GitHub Issues.
Version History
Recent Updates
| Version | Date | Major Changes |
|---|---|---|
| 1.2.0 | 2025-01 | Added full Cursor 0.40+ support |
| 1.1.0 | 2024-12 | Added content redaction feature |
| 1.0.0 | 2024-11 | Official release |
Compatibility Change Notes
Version 1.2.0:
- Added support for Cursor Composer mode
- Improved Gemini CLI tool call parsing
- Fixed some Windows path issues
Version 1.1.0:
- Added content redaction feature
- Improved large project loading performance
- Added Linux ARM64 support
Version 1.0.0:
- First official version
- Support for Claude Code, Gemini CLI, Cursor
- Core features: Time Travel, message filtering, content export
Next Steps
- Check Keyboard Shortcuts to improve your efficiency
- Read the FAQ to solve usage questions
- Start with Quick Start to experience Mantra