Installation

Requirements

• macOS, Linux, or Windows
• At least one AI CLI tool installed:
  • Claude Code
  • Gemini CLI
  • Or any other supported tool

Install Methods

Homebrew (Recommended)

brew tap mur-run/tap && brew install mur

From Source (Rust)

cargo install --git https://github.com/mur-run/mur.git

Upgrading from v1 (Go)

If you have the Go version installed:

# Install v2 via Homebrew
brew tap mur-run/tap && brew install mur

v2 reads v1 patterns automatically — no migration step required.

Verify Installation

mur --version

You should see something like:

mur 2.0.0-alpha.7

Optional: Semantic Search

For semantic pattern search, configure an embedding provider. mur init will guide you through this interactively. Or set up manually:

# Option 1: Ollama (free, local — recommended)
ollama pull qwen3-embedding:0.6b   # ~1.5GB RAM, fast
# or: qwen3-embedding:4b (8GB), qwen3-embedding:8b (16GB), nomic-embed-text (300MB)

# Option 2: OpenAI (~$0.001 per 200 patterns)
export OPENAI_API_KEY=sk-...

Then rebuild the index:

mur reindex

Next Steps

1. Quick Start — Initialize and create your first pattern
2. Configuration — Customize tools, search, and learning