Crush

Crush is a CLI + TUI AI programming tool that runs in the terminal, supporting multiple model integrations for code generation, debugging, conversation, file operations, and multitasking.

When using WisGate, configure the API endpoint https://api.wisgate.cn/v1.

1. Install Crush

Choose the installation method for your system:

Homebrew (macOS recommended):

brew install charmbracelet/tap/crush

NPM (cross-platform):

npm install -g @charmland/crush

2. Configure WisGate Models

1. Get Your API Key

Create and obtain your API Key from the WisGate dashboard.

2. Start Crush and Select Model

crush

In the model selection screen, select your desired model (e.g., gpt-5.5)

3. Enter API Key

Enter your WisGate API Key when prompted.

4. Modify Crush Configuration

Configuration file location:

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

{
  "providers": {
    "wisgate": {
      "id": "wisgate",
      "name": "WisGate Provider",
      "base_url": "https://api.wisgate.cn/v1",
      "api_key": "your_wisgate_api_key"
    }
  }
}

After configuration, restart Crush and use /models to select a specific model.

3. Use Cases

• Terminal coding: Run the TUI inside a project directory for code generation and edits.
• File operations: Let Crush read project context and assist with file edits.
• Debugging: Use command output, logs, and test results to generate fix suggestions.
• Multitasking: Split complex development requests into terminal-based tasks and complete them step by step.

FAQ

The configured model does not appear in /models

Confirm that the configuration file path is correct, the JSON format is valid, and restart Crush.

API calls fail

Confirm that base_url is https://api.wisgate.cn/v1 and api_key has been replaced with an API key created in the WisGate dashboard.