Command Reference

Complete list of MUR v2 commands.

Setup

Command	Description
`mur init`	Interactive setup wizard (models, hooks, config)
`mur init --hooks`	Skip interactive prompt and install hooks automatically

Pattern Management

Command	Description
`mur new`	Create a new pattern interactively
`mur new --diagram <path>`	Create pattern with Mermaid/PlantUML attachment
`mur pattern show <name>`	View pattern details and attachments
`mur search <query>`	Semantic + keyword hybrid search
`mur pin <name>`	Pin pattern (never auto-deprecated)
`mur mute <name>`	Mute pattern (skip injection)
`mur boost <name>`	Boost pattern importance (+0.1 default)
`mur promote <name>`	Promote pattern tier (→ project or core)
`mur deprecate <name>`	Deprecate a pattern manually
`mur links <name>`	Show bidirectional pattern connections

Sync & Injection

Command	Description
`mur sync`	Sync patterns to all enabled AI tools
`mur inject --query <q>`	Inject matching patterns for a query (hook integration)
`mur context`	Preview what would be injected (auto-detects project)
`mur context --compact`	Compact output with fewer patterns
`mur context --query <q>`	Query-specific context
`mur context --budget <n>`	Token budget (default: 2000)
`mur context --json`	Output as JSON instead of formatted text
`mur context --scope key=value`	Filter by scope (e.g. `--scope user=david`)

Learning & Feedback

Command	Description
`mur learn extract`	Extract patterns from session transcripts
`mur feedback helpful <name>`	Mark a pattern as helpful
`mur feedback unhelpful <name>`	Mark a pattern as unhelpful
`mur feedback auto`	Auto-analyze session for contradictions

Lifecycle & Intelligence

Command	Description
`mur evolve`	Run decay + maturity promotion/demotion
`mur evolve --dry-run`	Preview changes without saving
`mur evolve --consolidate`	Full consolidation (dedup, contradiction, promotion, decay, archival)
`mur emerge`	Detect emergent patterns from cross-session behaviors
`mur emerge --threshold 3`	Set minimum sessions for emergence
`mur suggest`	Show workflow composition & decomposition suggestions
`mur suggest --create`	Auto-create suggested items as drafts
`mur gc`	Garbage collect low-quality patterns
`mur gc --auto`	Auto-archive without prompting

Workflows

Command	Description
`mur workflow list`	List all workflows
`mur workflow show <name>`	Show workflow details
`mur workflow new`	Create a new workflow interactively

Session Recording

Command	Description
`mur session start`	Start recording a session
`mur session stop`	Stop recording
`mur session record`	Record an event to active session
`mur session status`	Show active session status
`mur session list`	List past session recordings

Community

Command	Description
`mur community list`	List community patterns
`mur community search`	Search community patterns
`mur community publish`	Publish a pattern
`mur community fetch`	Fetch (copy) a community pattern by ID
`mur community star`	Star a community pattern

Exchange (MKEF Format)

Command	Description
`mur exchange import <file>`	Import a single MKEF YAML file
`mur exchange import-all`	Import all MKEF files from `~/.mur/exchange/`
`mur exchange export <name>`	Export a pattern to MKEF format
`mur exchange export <name> --dir <path>`	Export to a specific directory

Dashboard & Stats

Command	Description
`mur stats`	Pattern library statistics
`mur dashboard`	Terminal dashboard (TUI)
`mur reindex`	Rebuild vector index from YAML files

Model Registry

Agents and the cost router draw from a provider/model registry at ~/.mur/models.yaml.

Command	Description
`mur model add <name> --provider <p> --model <id>`	Register a model. API keys go via `--secret` (`env:VAR`, `keychain:svc/acct`, `file:/path`, `cmd:./script`) — never stored in plaintext
`mur model add ... --tier local\|frontier`	Mark a model local (on-device, $0) or frontier (for cost-router escalation)
`mur model add ... --input-cost <usd> --output-cost <usd>`	Set USD-per-1k input/output pricing by hand
`mur model add ... --no-fetch`	Skip the automatic pricing lookup (otherwise input/output cost + context window are auto-filled from the models.dev catalog)
`mur model list`	List registered models
`mur model show <name>`	Show provider, model id, effective input/output cost, and context window
`mur model remove <name>`	Remove a model from the registry
`mur model prices refresh`	Refresh the cached models.dev price catalog (`~/.mur/cache/model-prices.json`)
`mur model prices show <name>`	Show the resolved pricing for a registered model
`mur model migrate`	Import a legacy `model:` config block into the registry

MUR Hub Model Library. The Hub desktop app provides a GUI over this registry: connect a cloud provider (Anthropic / OpenAI / DeepSeek / Google / OpenRouter / xAI / custom) with its API key saved to the macOS Keychain, or have it auto-detect local runtimes (Ollama / MLX / LM Studio). It discovers each provider's models via the OpenAI-compatible /v1/models endpoint, auto-fills pricing from models.dev, and adds your selections to the registry — no YAML editing required.

Command Tree

mur
├── init [--hooks]
├── new [--diagram <path>]
├── pattern show <name>
├── search <query>
├── pin <name>
├── mute <name>
├── boost <name> [--amount N]
├── promote <name> [--tier project|core]
├── deprecate <name>
├── links <name>
├── sync [--quiet]
├── inject --query <q> [--project <p>]
├── context [--compact] [--query <q>] [--budget N] [--json] [--scope key=val]
├── learn
│   └── extract
├── feedback
│   ├── helpful <name>
│   ├── unhelpful <name>
│   └── auto
├── evolve [--dry-run] [--force] [--consolidate]
├── emerge [--threshold N] [--dry-run]
├── suggest [--create]
├── gc [--auto]
├── exchange
│   ├── import <file>
│   ├── import-all
│   └── export <name> [--dir <path>]
├── workflow
│   ├── list
│   ├── show <name>
│   └── new
├── session
│   ├── start
│   ├── stop
│   ├── record
│   ├── status
│   └── list
├── community
│   ├── list
│   ├── search
│   ├── publish
│   ├── fetch
│   └── star
├── model
│   ├── add <name> --provider <p> --model <id> [--secret <ref>] [--tier local|frontier]
│   │            [--input-cost <usd>] [--output-cost <usd>] [--no-fetch]
│   ├── list
│   ├── show <name>
│   ├── remove <name>
│   ├── migrate
│   └── prices 
├── stats
├── dashboard
└── reindex