
Crush
A single-binary terminal agent from the Charm terminal-UI people, source-available until it turns MIT
What is Crush?
It installs as one Go binary from almost any package manager and runs on an unusually wide set of systems, including Windows PowerShell, WSL, Android and the BSDs. Inside, sessions are per project, the model can be swapped mid-conversation without losing context, and language servers feed it the same code intelligence an editor would. The licence is the thing to read first: it is not OSI-approved, it forbids offering a competing product, and each release only becomes MIT two years after it ships.
What can you do with Crush?
- Install one binary, anywhere — Homebrew, npm, Winget, Scoop, Nix, the Arch user repository and FreeBSD packages all carry it, and it is supported on macOS, Linux, Windows including PowerShell and WSL, Android and the BSDs.
- Change model without losing the thread — You can switch to a different LLM part-way through a session and keep the accumulated context, which matters when a cheap model has done the exploring and a stronger one should do the edit.
- Bring a model it has never heard of — Anything exposing an OpenAI- or Anthropic-compatible API can be added by hand, including a local Ollama model registered with its own name and context window.
- Keep several lines of work per project — Sessions are scoped to the project and kept separately, so an investigation and a refactor can sit side by side instead of contaminating one transcript.
- Extend it over three MCP transports — MCP servers can be attached over stdio, HTTP or server-sent events, and secrets in the configuration can be pulled from a command rather than pasted in as plain text.
Before you choose Crush
- The Functional Source License is not OSI-approved: internal use, non-commercial research and professional services are permitted, but making it available in a product that substitutes for Crush is not.
- The MIT grant is real but delayed: it takes effect on the second anniversary of each release, so the version you can freely redistribute today is always two years behind the current one.
Star history
21 Aug to 30 Oct · +1.3k
Frequently asked questions
Is Crush free for commercial use?
Crush is published under FSL-1.1-MIT, a source-available licence rather than OSI-approved open source — read its terms before relying on it commercially.
How can Crush be deployed?
Crush is available as Runs locally.