MUR/Docs/MUR
GitHub

Quick Start

Get up and running with MUR in 5 minutes.

Initialize

mur init

This launches an interactive setup wizard that:

  • Explains the recommended configuration (cloud LLM + local embedding)
  • Lets you choose your LLM provider (Anthropic, OpenAI, Gemini, OpenRouter, or Ollama)
  • Lets you choose your embedding model (Ollama or cloud)
  • Installs hooks for detected AI tools (Claude Code, Gemini CLI, etc.)

To install hooks automatically without prompts:

mur init --hooks

Create Your First Pattern

mur new

This opens an interactive prompt where you define:

  • Name — e.g., swift-testing-macro
  • Description — What the pattern is about
  • Content — Technical details and principles
  • Tags — Languages, topics
  • Tier — Session, Project, or Core

Or create a YAML file directly in ~/.mur/patterns/:

schema: 2
name: swift-testing-macro
description: Prefer Swift Testing over XCTest
content:
  technical: |
    Use @Test macro instead of func test...()
    Use #expect() instead of XCTAssert
    Use @Suite for test organization
  principle: |
    Swift Testing is more expressive and supports async natively.
    It's the future of testing in Swift.
tier: project
importance: 0.8
tags:
  languages: [swift]
  topics: [testing]
applies:
  languages: [swift]

Search Patterns

mur search "error handling"

MUR uses hybrid search: semantic similarity (via LanceDB) combined with BM25 keyword scoring.

Sync to AI Tools

mur sync

This pushes your patterns into the configuration of all enabled AI tools (Claude Code, Gemini CLI, etc.), so they automatically know your preferences.

Extract Patterns from Sessions

If you use Claude Code, Gemini CLI, or another supported tool with hooks installed, MUR records sessions automatically. Extract patterns with:

mur learn extract

Check Your Library

# Statistics overview
mur stats

# Terminal dashboard
mur dashboard

# View a specific pattern
mur pattern show swift-testing-macro

Evolve Your Patterns

Run the lifecycle engine to promote mature patterns and decay unused ones:

mur evolve

Patterns progress through maturity stages: Draft → Emerging → Stable → Canonical, and tier-based half-lives ensure unused patterns fade naturally.

What's Next?

  • Configuration — Customize search providers and learning settings
  • Patterns — Understand the v2 pattern format and lifecycle
  • Workflows — Create multi-step workflows
  • Commands — Full command reference