Install

Install the binary

Download the latest release for your platform from the GitHub releases page, or build from source with Cargo.

cargo install --git https://github.com/palmshed/mull

Mull is written in Rust. A recent stable toolchain and protoc are needed to build from source.

Authenticate

Mull uses OpenRouter so you can choose your own model and billing. Run login to open the keys page, then paste a key.

mull login
# 1) OpenRouter API key  (recommended)
# 2) GitHub device login
# Paste your key when prompted

Or skip the prompt and export the key directly:

export OPENROUTER_API_KEY=sk-or-...

The key is stored locally in ~/.mull/auth.json. It is never sent anywhere except OpenRouter.

Choose a model

Mull defaults to openrouter/free so you can try it without spending. Set a different model for heavier work.

mull --model openrouter/auto   Let Mull choose a model
mull --model openrouter/free   Use a free tier model

The default base URL is https://openrouter.ai/api/v1. Override it with CLI_CHAT_PROXY_BASE_URL if needed.

Start a session

Run Mull in a repository to begin. It reads the working tree, applies edits, and can run commands for you to review.

mull                         Interactive session
mull "explain how auth works"
mull "add a test for parse_config"
mull review                  Summarize uncommitted changes

Configuration

Optional settings live in ~/.mull/config.toml. Most users need none.

[mull]
model = "openrouter/auto"