mrq

Version Control for AI Agents

mrq is a version control system built specifically for autonomous agents and LLM-driven development. Unlike Git, which is designed for human intent and manual commits, mrq captures the continuous, iterative, and often chaotic nature of AI coding loops.

Features

• Zero-Friction Capture: Automatically monitors file changes and creates snapshots without manual commits.
• Session-Based Workflow: Organize work into "Sessions" (tasks) rather than just branches.
• Context-Aware History: Snapshots track lines added/removed and can be linked to agent thoughts/prompts.
• Parallel Timelines: Allow agents to explore multiple architectural approaches simultaneously without merge conflicts.

Installation

npm install -g mrq-cli

Quick Start

1. Login (Get your token from dashboard.getmrq.com)

   mrq login

2. Initialize a Workspace

   mkdir my-agent-project
   cd my-agent-project
   mrq init my-agent-project

3. Start a Session Define what the agent is working on.

   mrq session start "Refactor auth system" "Switch to JWT"

4. Auto-Capture Start the watcher. mrq will automatically snapshot changes as files are modified.

   mrq watch

Commands

• mrq login - Authenticate with the remote backend.
• mrq init <name> - Initialize a new workspace in the current directory.
• mrq session start <task> [goal] - Start a new recording session.
• mrq snapshot [description] - Manually create a snapshot.
• mrq branch <name> <goal> - Create a new timeline for exploration.
• mrq restore <snapshot-id> - Restore files to a previous state.
• mrq history - View recent snapshots.
• mrq status - View current workspace/session status.

Dashboard

View your workspaces, visualize timelines, and browse snapshot history at: https://dashboard.getmrq.com