Crush

Your new coding bestie, now available in your favourite terminal.
Your tools, your code, and your workflows, wired into your LLM of choice.

Features

• Multi-Model: choose from a wide range of LLMs or add your own via OpenAI- or Anthropic-compatible APIs
• Flexible: switch LLMs mid-session while preserving context
• Session-Based: maintain multiple work sessions and contexts per project
• LSP-Enhanced: Crush uses LSPs for additional context, just like you do
• Extensible: add capabilities via MCPs (http, stdio, and sse)
• Works Everywhere: first-class support in every terminal on macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, and NetBSD
• Industrial Grade: built on the Charm ecosystem, powering 25k+ applications, from leading open source projects to business-critical infrastructure

Quick Start

Install Crush via your package manager of choice:

# Homebrew
brew install charmbracelet/tap/crush

# NPM
npm install -g @charmland/crush

# Arch Linux
yay -S crush-bin

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

# FreeBSD
pkg install crush

Then run crush and pick your provider. See Getting Started for a full walkthrough.

Documentation

Section	Description
Getting Started	Your first session with Crush
Installation	All install methods
Configuration	crush.json, providers, LSPs, MCPs, hooks
Using Crush	TUI basics, sessions, permissions
CLI Reference	Commands, flags, and non-interactive mode
Skills	Agent skills discovery and user-invocable skills
Reference	Environment variables, safe commands, schema
Advanced	Notifications, metrics, provider updates, init
Troubleshooting	Common issues and fixes

Contributing

See the contributing guide.

Whatcha think?

We'd love to hear your thoughts on this project. Need help? We gotchu. You can find us on:

• Twitter
• Slack
• Discord
• The Fediverse
• Bluesky

License

FSL-1.1-MIT

---

Part of Charm.