Crush

Crush is a terminal-based agentic coding assistant from Charm. It runs as a TUI and connects to an LLM of your choice, giving the model access to your code, tools, and workflows. Providers include Charm's Hyper, Anthropic, OpenAI, Gemini, OpenRouter, Groq, Amazon Bedrock, Azure OpenAI, and Google VertexAI. Any OpenAI- or Anthropic-compatible API can be added as a custom provider, and local models such as Ollama are supported. Press ctrl+l to open the model picker and enter an API key, or set environment variables like ANTHROPIC_API_KEY or OPENAI_API_KEY.

Sessions are kept per project, and you can switch LLMs mid-session while preserving context. Crush pulls in extra context from language servers (LSPs) and can be extended with MCP servers over http, stdio, and sse. The README lists support for macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, and NetBSD.

Configuration is done with a crushrc, which is a Bash script with Crush-specific builtins such as provider add, model add, permissions allow, and mcp add. Crush has a built-in Bash interpreter, so the same config works on Windows. It is read from ./.crushrc, ./crushrc, or ~/.config/crush/crushrc, in that priority order. Crush also ships a builtin skill for configuring itself. The tool is aimed at developers who want an LLM coding agent in the terminal with a choice of model providers.

Installation

# via Homebrew
brew install charmbracelet/tap/crush

# via NPM
npm install -g @charmland/crush

# via Go
go install github.com/charmbracelet/crush@latest