Crush Integration

Crush is Charm's glamorous open-source AI coding agent for your terminal. Connecting it to OffRail takes a single provider entry in Crush's config — and gives you access to 200+ models from 40+ providers through one API key, with every request tracked in your dashboard.

Prerequisites

• Crush installed:

  # Homebrew
  brew install charmbracelet/tap/crush
  
  # NPM
  npm install -g @charmland/crush

  See the Crush README for Windows, Arch, Nix, and FreeBSD instructions.

• An OffRail API key — sign up and create one from your dashboard

Setup

export OFFRAIL_API_KEY=your-api-key-here

{
	"$schema": "https://charm.land/crush.json",
	"providers": {
		"offrail": {
			"name": "OffRail",
			"type": "openai-compat",
			"base_url": "https://api.offrail.ai/v1",
			"api_key": "$OFFRAIL_API_KEY"
		}
	}
}

crush

Why Use OffRail with Crush

• 200+ models — GPT-5, Claude, Gemini, Kimi, GLM, and more from 40+ providers
• One API key — Stop juggling credentials for every provider
• Cost tracking — See what each coding session costs in your dashboard
• Automatic fallback — Requests route to a healthy provider if one is down
• Volume discounts — The more you use, the more you save

Locking to a Specific Provider

By default, OffRail automatically fails over to alternative providers if your chosen provider is experiencing downtime. If you want to lock into a specific provider/model mapping — for example to guarantee a fixed price or to always use a single provider — add the X-No-Fallback header to your provider entry:

{
	"$schema": "https://charm.land/crush.json",
	"providers": {
		"offrail": {
			"name": "OffRail",
			"type": "openai-compat",
			"base_url": "https://api.offrail.ai/v1",
			"api_key": "$OFFRAIL_API_KEY",
			"extra_headers": {
				"X-No-Fallback": "true"
			}
		}
	}
}

Switching Models

Use Crush's model picker to switch between any of the discovered models.

Troubleshooting

401 Unauthorized

Verify OFFRAIL_API_KEY is exported in the shell where you launch Crush and that the key is active in your dashboard.

404 Not Found

Verify your base_url is set to https://api.offrail.ai/v1 (note the /v1 at the end).

Models not showing up

Model discovery runs when Crush starts — restart Crush after adding or changing the provider config.