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 | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Replay Mode | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Code snapshots | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Message filtering | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Content redaction | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Tool call viewing | ✅ | ⚠️ | ✅ | ✅ | 🔜 |
| Context Causality | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Code block highlighting | ✅ | ✅ | ✅ | ✅ | 🔜 |
| File tree browsing | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Git history matching | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Real-time sync | ✅ | ✅ | ✅ | ✅ | 🔜 |
| MCP Hub takeover | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Skills Hub takeover | ✅ | ✅ | ✅ | ✅ | - |
| Session live streaming | ✅ | ✅ | ✅ | ✅ | 🔜 |
| Remote SSH access | ✅ | ✅ | ✅ | ✅ | 🔜 |
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:
bash
# 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 |
|---|---|---|
| 0.11.0 | 2026-03-03 | Replay Mode, Context Causality |
| 0.10.0 | 2026-02-22 | Session Live Streaming, Remote SSH Project Access |
| 0.9.1 | 2026-02-15 | Search Result Precise Navigation, Skills Hub Project Integration Enhancement |
| 0.9.0 | 2026-02-14 | Skills Hub — Unified Skills Management |
| 0.8.2 | 2026-02-12 | Project-level MCP Management, Scoped Config Import |
| 0.8.1 | 2026-02-09 | Rebranding (MCP Hub), Single Instance Lock |
| 0.8.0 | 2026-02-09 | Auto-Updater System, Settings Overhaul, Tool Config Path UI |
| 0.7.0 | 2026-02-03 | MCP Hub, Built-in Inspector, System Tray |
| 0.6.0 | 2026-01-25 | Logical Project Aggregation, Renaming, Unlinking |
| 0.5.0 | 2026-01-20 | Refine Mode, Undo/Redo, Token Statistics |
| 0.4.0 | 2026-01-10 | Privacy & Security Module, Custom Detection Rules |
| 0.3.0 | 2025-12-30 | Privacy Sanitizer, Multi-Source Aggregation, Gemini Support |
| 0.2.0 | 2025-12-15 | Message Filtering, Code Snapshots, Global Search |
| 0.1.0 | 2025-12-01 | Initial Alpha Release |
Compatibility Change Notes
Version 0.11.0:
- Replay Mode: A brand new experience to reconstruct and validate AI operations step-by-step in a safe local workspace.
- Context Causality: Automatically analyzes and visualizes the logical causality between "reference files" and "code changes".
Version 0.10.0:
- Session Live Streaming: Real-time watching of in-progress sessions from all four AI tools (Claude Code, Codex, Cursor, Gemini CLI), both locally and remotely
- Remote SSH Access: Import and live-watch remote server sessions via SSH without installing anything on the remote server
- Import Page Redesign: Flat location-grouped layout unifying local and remote sources on the same page
Version 0.9.1:
- Search Result Navigation: Click global search results to precisely jump to the target message; multiple matches navigable with keyboard shortcuts
- Skills Hub Project Integration Enhancement: SkillContextCard compact overview, unmanaged Skill alert banner, bidirectional cross-page navigation
Version 0.9.0:
- Skills Hub: Brand new unified Skills management, supporting import from Claude Code, Cursor, Codex, and Gemini CLI
- Cross-tool Distribution: Import once, use everywhere via symlink distribution
- Project Linking: Supports both user-level and project-level Skill linking, symmetric design with MCP Hub
Version 0.8.2:
- Project-level MCP Management: Manage MCP service associations directly from project context menu
- Scoped Config Import: Auto-scan and filter based on project scope
- AppImage Compatibility: Fixed external process launch issues in AppImage environments
Version 0.8.0/0.8.1:
- Auto-Updater: Introduced built-in auto-update system with incremental updates and background downloading.
- Settings Overhaul: Settings page refactored into a sidebar navigation structure.
- Rebranding: "MCP Gateway" is officially renamed to "MCP Hub".
Version 0.7.0:
- MCP Hub: Deep integration of Model Context Protocol with SSE server support
- MCP Hub: Unified management for MCP services, environment variables, and OAuth credentials
- Tool Permission Management: Project-level granular tool interception and authorization (Tool Policy)
- System Tray: Background execution and quick access support
- UX Optimization: Migrated to Action Sheet interaction model for better complex form handling
Next Steps
- Check Keyboard Shortcuts to improve your efficiency
- Read the FAQ to solve usage questions
- Start with Quick Start to experience Mantra