Skip to main content

Crush

Crush is a terminal-based AI coding agent (CLI + TUI) that supports multiple models for code generation, debugging, and file operations.

Features​

  • Code Generation: Generate code from natural language
  • Debugging: Identify and fix issues in your code
  • File Operations: Create and modify files
  • Technical Q&A: Get answers to programming questions
  • TUI Interface: Interactive terminal user interface

Installation​

Homebrew (macOS)​

brew install charmbracelet/tap/crush

NPM (Cross-Platform)​

npm install -g @charmland/crush

Arch Linux​

yay -S crush-bin

Nix​

nix run github:numtide/nix-ai-tools#crush

Configuration for Apertis API​

Step 1: Get API Key​

Obtain your API key from Apertis Dashboard.

Step 2: Configure crush.json​

Create or edit the configuration file:

Location:

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

Configuration:

{
  "providers": {
    "apertis": {
      "id": "apertis",
      "name": "Apertis Provider",
      "base_url": "https://api.apertis.ai/v1",
      "api_key": "your_apertis_api_key"
    }
  }
}

Replace your_apertis_api_key with your actual API key.

Step 3: Launch Crush​

crush

Step 4: Switch Model​

Press Ctrl+P and select "Switch Model" to choose your preferred model.

Available Models​

ModelName
Claude Sonnet 4.5claude-sonnet-4.5
Claude Haiku 4.5claude-haiku-4.5
GPT-4ogpt-4.1
GPT-4o minigpt-4.1-mini
Gemini 3 Flashgemini-3-flash-preview

Keyboard Shortcuts​

ActionShortcut
Switch ModelCtrl+P
New ChatCtrl+N
QuitCtrl+C

MCP Integration​

Crush supports Model Context Protocol servers:

  • Vision Server: Analyze images and screenshots
  • Web Search Server: Search the web for information
  • Web Reader Server: Extract content from web pages

Troubleshooting​

Configuration Not Working​

  • Verify the config file location is correct
  • Check JSON syntax is valid
  • Ensure API key has no extra spaces

Connection Issues​

  • Verify your API key at Apertis Dashboard
  • Ensure the Base URL is https://api.apertis.ai/v1
  • Check your network connection