MUR/Docs/MUR
GitHub

Troubleshooting

Common Issues

Patterns not being injected

  1. Check that sync is working: mur sync
  2. Verify your patterns exist: mur stats
  3. Check what would be injected: mur context

Semantic search not working

  1. Ensure you have a search provider configured in ~/.mur/config.yaml
  2. Rebuild the index: mur reindex
  3. For Ollama: make sure the model is pulled (ollama pull qwen3-embedding)
  4. For OpenAI: verify your API key is set

Pattern extraction fails

  1. Check your LLM provider config under learning.llm in config
  2. Verify API keys are set in your environment
  3. Ensure session recordings exist: mur session list

Migrating from v1

If you previously used the Go version (v1):

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

v2 reads v1 patterns automatically — no migration step required.

Index corrupted

The vector index is fully rebuildable from YAML:

mur reindex

Hooks not firing

If Claude Code hooks aren't triggering:

# Reinstall hooks
mur init --hooks

This updates ~/.claude/settings.json with the necessary hook configuration.

Getting Help