Support

Common issues, troubleshooting, and how to get help.

Common issues

Ollama daemon is not reachable

The wizard couldn't connect to Ollama at localhost:11434. Start it manually:

# macOS
brew services start ollama

# Or one-off
ollama serve

For remote Ollama: export OLLAMA_HOST=http://host:11434

API key not found

The provider can't find a key in the OS keychain. Run the wizard to store one:

m init

Or set the env var directly: ANTHROPIC_API_KEY=sk-ant-... m

macOS Gatekeeper warning

The .pkg is unsigned. Right-click → Open to bypass, or:

xattr -d com.apple.quarantine ~/Downloads/m_*.pkg

Agent failed validation

Frontmatter has missing or invalid fields. Lint it:

m validate my-agent.md

Common causes: missing name, type, or model; model not in provider/model format; unknown field (typo).

secret-tool not found (Linux)

Install libsecret for keychain support:

# Debian/Ubuntu
sudo apt-get install libsecret-tools

# Fedora
sudo dnf install libsecret

# Arch
sudo pacman -S libsecret

Still stuck?