Support

Authentication

Mull authenticates with OpenRouter. The simplest path is mull login and pasting an API key. The key is saved to ~/.mull/auth.json.

mull login

If you prefer not to use the login prompt, export the key in your shell profile:

export OPENROUTER_API_KEY=sk-or-...

Mull checks the environment variable first, then the stored key file.

Invalid or missing key

If Mull reports an auth error, confirm the key is present and not expired. Re-run login to overwrite the stored key.

mull login
# choose "OpenRouter API key" and paste a fresh key

Keys are managed at openrouter.ai/keys. Ensure the key has credits or is on a free tier.

Model not found

An unknown model string produces a provider error. Verify the model exists on OpenRouter and is spelled exactly.

mull --model openrouter/free
mull --model openrouter/auto

openrouter/auto lets Mull select a capable model for the task.

Rate limits

Free and paid OpenRouter tiers have rate limits. If requests fail under load, wait and retry, or switch to a paid model with higher limits.

mull --model openrouter/auto

Base URL

The default endpoint is https://openrouter.ai/api/v1. Override it if you proxy requests or self-host a compatible gateway.

export CLI_CHAT_PROXY_BASE_URL=https://openrouter.ai/api/v1

Build from source

Building Mull needs a stable Rust toolchain and protoc for protocol buffers.

brew install protobuf        macOS
sudo apt install protobuf-compiler   Linux

Validation checklist

• Run mull login and confirm the key is saved to ~/.mull/auth.json
• Run mull "say hello" in a repository and confirm a model responds
• Confirm the model with --model if the default is unavailable
• Check OPENROUTER_API_KEY and CLI_CHAT_PROXY_BASE_URL when self-hosting a gateway