Apertis Docs
Apertis Docs

Integrations

Crush

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

Updated
Reading time
2 min
Ask ClaudeAsk ChatGPTOpen in Cursor
View as Markdown

On this page

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

Model Name
Claude Sonnet 4.6 claude-sonnet-4-6
Claude Haiku 4.5 claude-haiku-4-5
GPT-5.5 gpt-5.5
GPT-5.4 mini gpt-5.4-mini
Gemini 3.5 Flash gemini-3.5-flash

Keyboard Shortcuts

Action Shortcut
Switch Model Ctrl+P
New Chat Ctrl+N
Quit Ctrl+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