Crush

iBefore you start

Crush is installed and available as crush.
A working Yolo Router endpoint, for example https://api.yolorouter.com.
A Yolo Router API Key generated from the console.
The model ID you want to use, for example deepseek-v4-pro. It must exactly match the model ID in the Yolo Router console.

Crush connects to OpenAI-compatible services through an openai-compat provider. For Yolo Router, base_url must end with /v1.

Setup

Install Crush

Install with npm:

npm install -g @charmland/crush

macOS users can also install with Homebrew:

brew install charmbracelet/tap/crush

Verify:

crush --version

Edit the config file

Crush config file location:

Linux / macOS: ~/.config/crush/crush.json
Windows: %USERPROFILE%\.config\crush\crush.json

Create it if it does not exist, then write:

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "yolorouter": {
      "type": "openai-compat",
      "base_url": "https://api.yolorouter.com/v1",
      "api_key": "$YOLOROUTER_API_KEY",
      "models": [
        {
          "id": "deepseek-v4-pro",
          "name": "deepseek-v4-pro",
          "context_window": 128000,
          "default_max_tokens": 8192,
          "can_reason": true
        },
        {
          "id": "deepseek-v4-flash",
          "name": "deepseek-v4-flash",
          "context_window": 128000,
          "default_max_tokens": 8192,
          "can_reason": false
        }
      ]
    }
  }
}

Field notes:

type must be openai-compat
base_url must end with /v1
api_key uses the $YOLOROUTER_API_KEY variable reference so you do not commit the Key
models[].id must exactly match the model ID in the Yolo Router console

Set the API Key env var

export YOLOROUTER_API_KEY="sk-yolo-..."

$env:YOLOROUTER_API_KEY = "sk-yolo-..."

set YOLOROUTER_API_KEY=sk-yolo-...

Persist it in your shell profile or system environment for convenience. Do not commit the real API Key to your repository.

Launch and pick a model

Open your project directory and start Crush:

cd /path/to/my-project
crush

Press Ctrl+L, or type /model, to open the model switcher. Choose the yolorouter provider, then pick:

deepseek-v4-pro

Test the connection

Send this in Crush:

Introduce the model you are using in one sentence.

If Crush returns a normal response, the integration is working. You can also check the Yolo Router console for the corresponding request log.

Troubleshooting

yolorouter does not appear in the model switcher

Check the crush.json path and JSON format. Restart Crush after changing the config.

401 Unauthorized

Make sure YOLOROUTER_API_KEY is exported in the current shell and has no extra spaces.

Model not found

Confirm that models[].id exactly matches the model ID in the Yolo Router console.

Config changes do not apply

Restart Crush.

On this page