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\

GitHub Copilot Chat

Version	Support Status	Notes
latest	✅ Full support	v0.12.0+

Supported features:

✅ Conversation log import (local + remote SSH)
✅ Time Travel (code snapshots)
✅ Message filtering
✅ Content redaction
✅ Tool call viewing
✅ Code block highlighting
✅ File tree browsing
✅ Live updates (file monitoring)
✅ Multi-distribution disambiguation (VSCode / JetBrains / Insiders)

Log location:

macOS (VSCode): ~/Library/Application Support/Code/User/globalStorage/github.copilot-chat/
Linux (VSCode): ~/.config/Code/User/globalStorage/github.copilot-chat/
Windows (VSCode): %APPDATA%\Code\User\globalStorage\github.copilot-chat\

OpenCode

Version	Support Status	Notes
latest	✅ Full support	v0.12.0+

Supported features:

✅ Conversation log import (local)
✅ Time Travel (code snapshots)
✅ Message filtering
✅ Content redaction
✅ Tool call viewing
✅ Code block highlighting
✅ File tree browsing
✅ Live updates (SQLite incremental polling)

Log location:

macOS: ~/Library/Application Support/opencode/opencode.db
Linux: ~/.local/share/opencode/opencode.db
Windows: %APPDATA%\opencode\opencode.db

Feature Support Matrix

The following table shows Mantra feature support across AI tools:

Feature	Claude Code	Gemini CLI	Cursor	Codex	Copilot Chat	OpenCode
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 applicable

Operating System Requirements

Installer Formats by Platform

Platform	Available Formats	Notes
macOS	`.dmg` (separate arm64 / x64 builds)	Pick by chip type
Windows	`.exe` (NSIS), `.msi` (WiX)	Identical functionality; MSI suits enterprise deployment
Linux	`.deb`, `.rpm`, `.AppImage`	Identical functionality; AppImage has the widest compatibility

Installers follow the naming pattern Mantra_{version}_{platform}-{arch}.{ext}. See the Installation Guide for step-by-step instructions.

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. Download the build whose filename contains macos-arm64 — using the Intel build (macos-x64) by mistake makes the app run through Rosetta 2 translation with noticeably worse performance.

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 22.04+, Fedora 36+, Debian 12+
Architecture support	x64 (64-bit)
Disk space	At least 500MB free space
Memory requirement	Minimum 4GB, recommended 8GB+

Supported distributions:

Ubuntu 22.04 LTS, 24.04 LTS
Fedora 36 and later
Debian 12 (Bookworm) and later
Linux Mint 21+
Arch Linux (via AppImage)

Ubuntu 20.04 / Debian 11 Cannot Use DEB/RPM

Mantra is built against WebKit2GTK 4.1 (official build environment: Ubuntu 22.04). Ubuntu 20.04 and Debian 11 only ship WebKit2GTK 4.0, so the DEB/RPM packages won't run there. Use the AppImage on those systems — it bundles the required runtime.

Dependency requirements:

DEB/RPM installs resolve dependencies automatically, so you normally don't need to install anything by hand. To verify manually:

bash

# Debian 12+ / Ubuntu 22.04+
sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 libayatana-appindicator3-1

# Fedora 36+
sudo dnf install webkit2gtk4.1 gtk3 libappindicator-gtk3

The AppImage bundles the dependencies above and only needs FUSE from the system:

bash

# Debian/Ubuntu
sudo apt install fuse libfuse2

# Fedora
sudo dnf install fuse fuse-libs

System 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

Compatibility ​

Supported AI Tools ​

Claude Code ​

Gemini CLI ​

Cursor ​

Codex ​

GitHub Copilot Chat ​

OpenCode ​

Feature Support Matrix ​

Operating System Requirements ​

macOS ​

Windows ​

Linux ​

System Resource Recommendations ​

Known Limitations ​

Claude Code Limitations ​

Gemini CLI Limitations ​

Cursor Limitations ​

General Limitations ​

Coming Soon ​

More AI Tools ​

Feature Enhancements ​

Version History ​

Recent Updates ​

Compatibility Change Notes ​

Next Steps ​

Compatibility

Supported AI Tools

Claude Code

Gemini CLI

Cursor

Codex

GitHub Copilot Chat

OpenCode

Feature Support Matrix

Operating System Requirements

macOS

Windows

Linux

System Resource Recommendations

Known Limitations

Claude Code Limitations

Gemini CLI Limitations

Cursor Limitations

General Limitations

Coming Soon

More AI Tools

Feature Enhancements

Version History

Recent Updates

Compatibility Change Notes

Next Steps