Crush

Crush is Charm’s terminal coding agent. Route it through Edgee to reduce token costs with lossless compression and gain full observability over every session.

Edgee CLI setup (recommended)

The fastest way to connect Crush to Edgee is the CLI. It authenticates, merges an Edgee provider into your Crush config (populated from the live Edgee model catalog), and starts Crush, no config file to edit by hand.

Install the Edgee CLI

macOS / Linux
Homebrew (macOS)
Windows (PowerShell)

curl -fsSL https://edgee.ai/install.sh | bash

brew install edgee-ai/tap/edgee

irm https://edgee.ai/install.ps1 | iex

Launch Crush through Edgee

edgee launch crush

The CLI authenticates, adds the edgee provider, and starts Crush. Token compression is enabled automatically. Pick an Edgee model from Crush’s model picker.

Crush must already be installed. See the Crush repository for install instructions.

After the session ends, the CLI prints a link to view token usage, compression savings, and cost breakdown in the Edgee Console.

Manual setup (advanced)

Prefer to configure Crush yourself? Add an OpenAI-compatible provider pointed at Edgee to your global crush.json (~/.config/crush/crush.json):

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "edgee": {
      "id": "edgee",
      "name": "Edgee",
      "type": "openai-compat",
      "base_url": "https://edgee.io/v1",
      "api_key": "<YOUR_EDGEE_API_KEY>",
      "extra_headers": {
        "x-edgee-api-key": "<YOUR_EDGEE_API_KEY>"
      },
      "discover_models": true
    }
  }
}

Replace <YOUR_EDGEE_API_KEY> with your actual Edgee API key from the Edgee Console. With discover_models enabled, Crush populates its model picker from the Edgee catalog.

Benefits

Cost reduction

Edgee’s token compression reduces the tokens sent to and from the model, with no change to output quality.

Observability

Every request is logged in the Edgee Console with token counts, latency, and cost breakdowns.

Reliability

Automatic retry and fallback across providers keeps your sessions running even when a provider has issues.

One command

No config to edit, the CLI wires everything up.

Next Steps

Learn more about the Edgee CLI and its launch commands
Set up observability to monitor usage and costs
Explore retry and fallback for resilient routing

Introduction

Quickstart

Features

Self-Hosting

Integrations

Edgee CLI setup (recommended)

Manual setup (advanced)

Benefits

Cost reduction

Observability

Reliability

One command

Next Steps

​Edgee CLI setup (recommended)

​Manual setup (advanced)

​Benefits

Cost reduction

Observability

Reliability

One command

​Next Steps

Edgee CLI setup (recommended)

Manual setup (advanced)

Benefits

Next Steps