Skip to content
/

Mantra

mantra · mantra-hq/mantra-releases · ★ 7 · last commit 2026-05-26

Primitive shape
No installable primitives
00

Summary

Mantra — Summary

Mantra is a cross-platform desktop application (macOS/Windows/Linux) that turns AI coding sessions into navigable, replayable timelines — letting developers scrub through conversations and watch code evolve in real time as if rewinding a video.

Problem it solves: AI coding sessions produce large conversation logs but no way to understand when specific changes were made or to recover from a bad decision mid-session. Mantra maps each conversation turn to the filesystem state at that moment, enabling click-to-time-travel to any point in the session history.

Distinctive trait: The time-travel metaphor is implemented: scrubbing forward/backward through the conversation timeline shows the full state of every file, highlighted diffs, tool calls, and file tree — all synchronized. This is fundamentally different from session viewers (Poirot, opcode) which show the log but not the synchronized code state.

Additional features: MCP Hub (manage MCP servers across all AI tools from one interface), Skills Hub (share reusable Skills across Claude Code, Codex, and other tools), content redaction for sensitive data before sharing sessions, and full-text message filtering.

Tech stack: Closed-source commercial app built with Rust + React (per structured data on website); v0.11.0; free. Release-only GitHub repository (mantra-hq/mantra-releases, 7 stars) with no source code published.

Target audience: Developers using Claude Code, Cursor, Gemini CLI, or Codex who want to understand session history causally ("what change was caused by which message?") and recover from problematic sessions by rewinding to a known-good state.

Production-readiness: v0.11.0, free, available on macOS/Windows/Linux. 7 stars on release repo; maintained by mantra-hq org; pushed May 2026.

differs_from_seeds: None of the 11 seeds provide session time-travel or file-state synchronization. The closest seed conceptually is ccmemory (session data handling) but ccmemory stores knowledge, not file state. Mantra's MCP Hub and Skills Hub add cross-tool management functions that overlap with marketplace-flavored repos from other batches.

01

Overview

Mantra — Overview

Origin

Mantra is built by the mantra-hq organization. The GitHub presence is a releases-only repository (mantra-hq/mantra-releases) — source code is not public. The landing page is at mantra.gonewx.com; documentation at docs.mantra.gonewx.com. The project uses a Discord community (discord.gg/hZ73MMfJxy) and email support (mantra@gonewx.com).

Philosophy

From the README:

"Instead of scrolling through endless chat logs, you can scrub through your entire session like a video — seeing exactly how your code evolved with every AI interaction."

Mantra's core insight is that AI coding sessions are causal sequences: each conversation turn causes a set of file changes. If you can map turns to file states, you can navigate the session bidirectionally — both to understand what happened and to recover from mistakes.

The product description emphasizes:

  • Replayability over session viewing (scroll back to the code state, not just the message)
  • Local-first as a privacy and reliability feature ("no cloud accounts, no telemetry")
  • Multi-tool as a practical feature (developers use multiple AI tools; one viewer for all)

Structural data schema (from website JSON-LD)

{
  "@type": "SoftwareApplication",
  "name": "Mantra",
  "description": "local-first desktop application that replays AI coding sessions 
                  from Claude Code, Cursor, and Gemini CLI",
  "softwareVersion": "0.11.0",
  "featureList": "Session Replay, Time Travel, MCP Hub, Skills Hub, 
                  Sensitive Info Detection, Full-Text Search",
  "offers": {"price": "0", "priceCurrency": "USD"}
}

Roadmap items visible

From support table:

  • Antigravity support: "coming soon"
  • OpenAI Codex: already supported since v1.0.0

Relationship to the "Claude Code sessions time machine" concept

The FAQ on the website addresses positioning directly:

"Mantra is built for developers who use AI coding tools like Claude Code, Cursor, or Gemini CLI daily. It is especially valuable if you want to replay AI decision processes, manage MCP services across multiple tools, or detect sensitive data like API keys before sharing sessions."

This positions Mantra as a post-session forensics and pre-sharing safety tool, not a real-time companion.

02

Architecture

Mantra — Architecture

Distribution

  • Closed-source binary releases at mantra-hq/mantra-releases/releases
  • Platforms: macOS 12.0+, Windows 10 (1903+), Linux (Ubuntu 20.04+ / Fedora 35+ / Debian 11+)
  • Minimum: 4 GB RAM, 500 MB disk

Tech stack (from website structured data)

  • Backend: Rust (per SoftwareApplication schema + blog/changelog references)
  • Frontend: React (per website architecture references)
  • Source code: Not published (closed source)

Session import architecture

  1. User uses AI coding tool normally (Claude Code, Codex, Gemini CLI, Cursor)
  2. Mantra Import Wizard auto-detects sessions from local tool logs
  3. User selects a session to import
  4. Mantra maps conversation turns to file system states
  5. Timeline scrubber becomes navigable

Time-travel implementation (inferred)

Based on feature descriptions, Mantra must:

  1. Parse session JSONL (or equivalent) to identify conversation turns
  2. Extract file operation records (write/edit/create/delete) per turn
  3. Build a deterministic file state graph from turn 0 to turn N
  4. Allow scrubbing by re-applying or reversing operations to any target turn

This is structurally similar to git's commit graph but operating on AI session turns rather than explicit commits.

MCP Hub architecture (inferred)

Mantra's MCP Hub aggregates MCP server configurations across all supported tools:

  • Claude Code's ~/.claude/claude_desktop_config.json
  • Cursor's MCP config
  • Gemini CLI's MCP config (if any) Into a unified management interface.

Skills Hub architecture (inferred)

Skills Hub aggregates skill definitions from:

  • Claude Code's .claude/skills/ directories
  • Codex skill equivalents Into a shared browser for cross-tool skill management.

Local-first guarantee

Per README and FAQ:

  • No cloud accounts required
  • No telemetry
  • No data leaving the machine
  • All session data stays local
03

Components

Mantra — Components

Mantra is closed-source. Component descriptions are based on the public README and website.

Core features

Feature Description
Session Import Wizard Auto-detects sessions from local AI tool logs; guided import flow
Timeline Scrubber Video-style playback control for conversation turns
Synchronized File Viewer Full state of every file at each conversation turn
Diff Viewer Highlighted diffs showing what changed at each turn
File Tree View Project structure synchronized with timeline position
Tool Call Viewer Tool invocations at each turn (synchronized with code state)
Conversation View Full conversation with message filtering
Full-Text Search/Filter Find specific messages in conversation history

MCP Hub

  • Centralizes MCP server management across all supported AI tools (Claude Code, Codex, Cursor, Gemini CLI)
  • Add/remove/configure MCP servers from one interface
  • Permissions management across tools

Skills Hub

  • Browse and manage reusable Skills across Claude Code, Codex, and other supported tools
  • Share skills between tool configurations
  • Cross-tool skill synchronization

Content Redaction

  • Detect sensitive information in sessions (API keys, passwords, credentials)
  • Redact before sharing session exports
  • Safety feature for team collaboration

Multi-Mode Interface

Three viewing modes:

  • Conversation-focused
  • Code-change-focused
  • File tree-focused

Supported tools

Tool Session replay Import Since
Claude Code Full Auto-detect v1.0.0
Codex Full Auto-detect v1.0.0
Gemini CLI Full Auto-detect v1.0.0
Cursor Full Auto-detect v0.35.0
Antigravity Coming soon
05

Prompts

Mantra — Prompts

Mantra ships no prompting primitives for Claude Code users. It is a closed-source session viewer with no skill, command, hook, or MCP component.

No prompt files are accessible in the public mantra-hq/mantra-releases repository (releases-only, no source).

The website FAQ is the closest thing to a design philosophy document:

"Mantra is a free, local-first desktop application that replays AI coding sessions from Claude Code, Cursor, and Gemini CLI. Click any message to time-travel to that exact code state. Detect sensitive data, manage MCP services, and search across all sessions — 100% offline on macOS, Windows, and Linux."

The FAQ also articulates the target user:

"Mantra is built for developers who use AI coding tools like Claude Code, Cursor, or Gemini CLI daily. It is especially valuable if you want to replay AI decision processes, manage MCP services across multiple tools, or detect sensitive data like API keys before sharing sessions."

These are product positioning statements, not prompting techniques.

09

Uniqueness

Mantra — Uniqueness & Positioning

differs_from_seeds

Mantra is unlike all 11 seeds — it is a post-session forensics tool that adds no agent behavior:

  • vs. all methodology seeds: Those prescribe what agents should do. Mantra records and visualizes what they did.
  • vs. MCP-toolserver seeds: Those add tools to agents. Mantra manages MCP server configuration across tools.
  • vs. ccmemory: ccmemory stores persistent knowledge for agents. Mantra stores session histories for human review.

Most distinctive feature

The synchronized time-travel feature is unique in the corpus: clicking any conversation turn shows the exact file state at that moment. No other tool in Phase D (or the 11 seeds) builds this conversation-turn-to-filesystem-state mapping.

This is architecturally non-trivial: it requires parsing AI tool output formats to extract file operation sequences, building a state graph, and providing O(1) random-access to any point in that graph.

Positioning within the batch

Tool Primary value
opcode Visual management + agent creation
Poirot Rich session browser + configuration viewer
Agent FM Audio narration of live sessions
Anima Gamified companion for live sessions
Mantra Post-session time-travel + MCP/Skills management

Mantra has the widest tool coverage (4 AI tools) and the only cross-platform desktop distribution (macOS + Windows + Linux). Poirot is macOS-only and read-only; opcode is in alpha with no published binaries; Mantra is production-ready on all platforms.

Observable failure modes

  1. Closed source: No way to audit the session parsing logic, storage schema, or redaction implementation.
  2. 7 stars on release repo: Low community traction for a production tool with wide platform coverage.
  3. Unknown maintenance team: No contributor counts or GitHub profile prominence for mantra-hq.
  4. Closed-source MCP Hub writes: The MCP Hub writes back to tool config files — incorrect writes could break Claude Code / Cursor MCP configurations.
  5. Session format fragility: If AI tools change their JSONL/session formats, Mantra's import breaks silently.
  6. Free pricing with no stated revenue model: Long-term sustainability unclear for a well-featured product with no monetization path.
04

Workflow

Mantra — Workflow

Mantra is a post-session analysis tool. It imposes no development methodology.

Import and review workflow

1. Use AI coding tool normally (Claude Code, Codex, Cursor, Gemini CLI)
2. Launch Mantra
3. Import Wizard auto-detects sessions → select session to import
4. Session loads as navigable timeline
5. Use scrubber to move through conversation turns
   → See file state at each turn
   → Compare diffs between turns
   → Read conversation context for each turn
6. (Optional) Filter messages by full-text search
7. (Optional) Use content redaction before sharing

MCP management workflow

Settings → MCP Hub
→ View all MCP servers across Claude Code, Codex, Cursor, Gemini CLI
→ Add/remove/configure servers
→ Manage permissions across tools

Skills sharing workflow

Skills Hub
→ Browse skills from all supported tools
→ Cross-tool skill synchronization (share skills between tools)

Session sharing workflow

Session timeline → Content Redaction
→ Detect sensitive data (API keys, credentials)
→ Redact specific content
→ Export redacted session for sharing

Phases

None — all features are available at any time.

Artifacts

None produced. Mantra reads existing session logs; redacted exports are the only output.

Approval gates

None.

06

Memory Context

Mantra — Memory & Context

State storage

Mantra stores imported session data locally. Mechanism is not publicly documented (closed source).

  • Imported sessions: Parsed and indexed locally for timeline navigation
  • MCP configurations: Reads from all supported tool config files; writes through MCP Hub
  • Skills configurations: Reads from all supported tool skill directories

Persistence scope

  • Local only: No cloud sync, no account, no telemetry
  • Session imports: Persisted until user removes them
  • Configuration changes: Written back to the respective tool's config files (via MCP Hub, Skills Hub)

Context compaction

Not applicable — Mantra reads completed sessions. Compaction is transparent.

Cross-session handoff

None — Mantra is post-session forensics, not session continuation.

Time-travel state reconstruction

The time-travel feature requires Mantra to maintain a reconstructed file state graph for each imported session. This is likely stored as a delta graph (file operations per turn) rather than full file snapshots. The storage requirement is undocumented.

07

Orchestration

Mantra — Orchestration

Multi-agent

No — Mantra observes completed sessions, it does not orchestrate agents.

Orchestration pattern

None.

Isolation mechanism

None.

Execution mode

Interactive GUI (post-session forensics).

Multi-model

No — Mantra supports multiple AI tools (Claude Code, Codex, Gemini CLI, Cursor) but does not orchestrate models.

Consensus mechanism

None.

Auto-validators

None — the content redaction feature automatically detects sensitive data patterns (API keys, credentials), which is the closest thing to automated analysis, but it is a safety check, not an agent validator.

08

Ui Cli Surface

Mantra — UI & CLI Surface

Desktop application (primary surface)

Cross-platform desktop app (macOS/Windows/Linux).

Key UI surfaces:

Surface Function
Import Wizard Session discovery and import from local tool logs
Timeline view Video-scrubber for conversation turns
File state viewer Synchronized code view at each turn
Diff viewer Highlighted per-turn file changes
File tree Project structure synchronized with timeline
Conversation view Full message history with filtering
MCP Hub Cross-tool MCP server management
Skills Hub Cross-tool skill browsing and sharing
Content Redaction Sensitive data detection and redaction
Search Full-text search across messages

CLI binary

None.

IDE integration

None.

Distribution

  • Closed-source release binaries on mantra-hq/mantra-releases
  • macOS 12+ / Windows 10+ / Linux (Ubuntu 20.04+ / Fedora 35+)
  • Free (per website: price "0 USD")

Local-first

All data stays on device:

  • No cloud account or login
  • No telemetry
  • Works 100% offline
  • Session data never leaves the machine

Related frameworks

same archetype · same primary tool · same memory type

Goose (Block/AAIF) ★ 46k

General-purpose AI agent (not just code) with security-first tool inspection, recipe-based shareable configurations, and 15+ LLM…

Vibe Kanban ★ 27k

Eliminate the overhead of planning, switching between agent terminals, and reviewing diffs by providing a single web dashboard…

1Code ★ 5.5k

Cursor-like desktop experience for Claude Code and Codex with cloud background agents, event-driven automations, and a full…

Crystal (stravu) ★ 3.1k

Manage multiple parallel AI coding sessions in isolated git worktrees from a single desktop GUI.

Maestro (RunMaestro) ★ 3.0k

Orchestrate unlimited parallel AI agent sessions with a keyboard-first desktop app including Group Chat coordination and Auto Run…

AgentsMesh ★ 2.1k

Multi-tenant workforce platform that gives every team member a squad of AI coding agents coordinated through channels, pod…