Crush

Crush is a terminal-based AI coding assistant by Charmbracelet. It supports multiple LLM providers, LSP integration, MCP servers, and session-based context management. You can configure it to use AI Gateway for unified model access and spend monitoring.

1. Create an API Key

   Go to the AI Gateway tab of the Vercel dashboard and click API Keys to create a new API Key.

2. Install Crush

   Choose your preferred installation method:

   HomebrewnpmGo

   Terminal

   brew install charmbracelet/tap/crush

   Terminal

   npm install -g @charmland/crush

   Terminal

   go install github.com/charmbracelet/crush@latest

   See the Crush installation guide for additional installation options including Windows, Debian/Ubuntu, and Fedora/RHEL.

3. Configure AI Gateway

   Start Crush:

   Terminal

   crush

   When prompted:

   1. Select Provider: Choose Vercel AI Gateway
   2. Select Model: Pick from AI Gateway's model library
   3. Enter API Key: Paste your AI Gateway API Key when prompted

   Crush saves your API Key to ~/.local/share/crush/crush.json, so you only need to enter it once.

   Your requests will now be routed through AI Gateway. You can verify this by checking your AI Gateway Overview in the Vercel dashboard.

4. (Optional) Monitor usage and spend

   View your usage, spend, and request activity in the AI Gateway tab of the Vercel dashboard. See the observability documentation for more details.