Crush
Free, open-source terminal-native AI coding assistant with multi-model support.
Crush is a capable, free, open-source terminal AI assistant for developers who want multi-model flexibility and deep CLI integration. It requires manual setup and API keys, but offers unmatched extensibility via MCPs and LSPs. Best for power users who prefer terminal workflows over IDEs.
Verified 17d ago · liveness 69/100 · cite: rightaichoice.com/tools/crush
- Terminal-loving developers who want an AI assistant integrated into their CLI workflow
- Users who need multi-model flexibility to compare or switch LLMs per task
- Developers working on headless servers or via SSH who need AI assistance in the terminal
- Power users who want extensibility via MCPs and custom LSP integrations
- Users seeking a graphical, IDE-like AI coding assistant with no terminal use
- Non-developers or beginners who want a zero-config, cloud-hosted AI coding tool
- Teams requiring centralized billing, usage controls, or admin dashboards
We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.
- Honest verdict, not marketing
- Real pros & cons from real users
- Attributed quotes with receipts
3 free scans · no card needed
Skip Crush if you need a graphical AI coding assistant with a GUI, zero setup, or team management features.
No hidden costs from Crush itself, but you must pay API providers directly — usage costs can add up if you use expensive models like GPT-4o.
Crush is completely free and open-source with no subscription tiers. You only pay for API usage with your chosen LLM providers. This makes it ideal for budget-conscious individual developers, but teams may need to manage billing through their provider accounts.
In short
Crush — Free, open-source terminal-native AI coding assistant with multi-model support. Best for Terminal-loving developers who want an AI assistant integrated into their CLI workflow, Users who need multi-model flexibility to compare or switch LLMs per task, Developers working on headless servers or via SSH who need AI assistance in the terminal. Free to use.
Viability Score
How likely is Crush to still be operational in 12 months? Based on 4 signals — momentum (how recently it shipped), wrapper dependency, revenue model, and web presence.
Last calculated: July 2026
How we score →Key Features
- Multi-model support: OpenAI, Anthropic, Groq, OpenRouter, Vercel AI Gateway
- Mid-session LLM switching with preserved context
- Session-based workflows for multiple contexts per project
- LSP-enhanced code understanding using language servers
- Extensible via MCPs: HTTP, stdio, SSE
- Cross-platform: macOS, Linux, Windows, Android, FreeBSD, OpenBSD, NetBSD
- Built on Charm ecosystem (25k+ applications)
- Install via Homebrew, npm, Arch Linux, Nix, Winget, Scoop, Debian, Fedora, Go
- Open-source (MIT license) on GitHub
- Environment variable configuration for API keys
- NixOS and Home Manager module support via NUR
- Compact TUI mode and debug options
- Supports Anthropic and OpenAI compatible APIs
- Experimental: .agents folder for defining custom agents
- Command approval gates for shell execution safety
About Crush
Crush is a free, open-source terminal-based AI coding assistant built by Charmbracelet that brings agentic coding capabilities directly into your terminal. It supports multiple LLMs including OpenAI, Anthropic, Groq, OpenRouter, and Vercel AI Gateway, with the ability to add providers via OpenAI- or Anthropic-compatible APIs. Key features include multi-model support with mid-session model switching while preserving context, session-based workflows for multiple contexts per project, LSP-enhanced code understanding using language servers, and extensibility via MCPs (HTTP, stdio, SSE). Crush runs on macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, and NetBSD, and can be installed via Homebrew, npm, Arch Linux, Nix, Winget, Scoop, Debian, Fedora, and Go. It is free and open-source under the MIT license—you only pay for API usage with providers. It offers a compact TUI mode, environment variable configuration for API keys, and NixOS/Home Manager module support via NUR. Developers who want a flexible, terminal-native AI assistant with multi-model flexibility and deep integration into existing tools will find Crush a powerful alternative to cloud-based coding assistants like GitHub Copilot or Aider.
Behind the Verdict
If you live in the terminal, Crush is one of the most flexible AI coding assistants you can run. Multi-model switching mid-session is a standout—you can start with a cheap model for quick edits and swap to a smarter one for debugging, all without losing context. The LSP integration means it understands your codebase similarly to an IDE, and the MCP support lets you plug in custom tools. However, there's a setup cost: you need API keys, and configuration can get complex, especially for NixOS modules or custom providers. Crush isn't for teams needing centralized billing or non-developers who want a GUI. Compared to Aider, Crush is more terminal-native and supports more providers out of the box (including OpenRouter and Vercel AI Gateway). GitHub Copilot offers a richer IDE experience but locks you into OpenAI models. The experimental .agents folder is a promising step toward customizable agentic workflows. In practice, Crush excels for developers working on headless servers, via SSH, or who want to avoid vendor lock-in. The main caveat: the command approval gates are good for safety but can slow down autonomous workflows.
Researching Crush? Get your full AI stack in 60 seconds.
Free, no signup — tell us your goal and get tools matched to your budget & existing stack.
Real-world workflow fit
Concrete scenarios for the personas Crush actually fits — and what changes day-one when you adopt it.
You SSH into a headless Linux server and need AI assistance without an IDE. You install Crush via Homebrew, configure your API keys via environment variables, and start a session. You ask Crush to review a Go function; it uses the Go LSP to provide contextual suggestions.
Outcome: You get AI-powered code analysis and fixes directly in your terminal, with no need for a graphical environment.
You have a code generation task and want to compare responses from GPT-4o, Claude Sonnet, and a local Llama model. With Crush, you start a session, generate code with one model, then switch to another mid-session without losing conversation history.
Outcome: You select the best output by comparing multiple LLMs in a single terminal session, improving code quality.
You use NixOS and want to integrate Crush into your flake-based configuration. You import the NUR module and enable Crush with your API keys defined in your Nix config. Crush is available system-wide.
Outcome: Your AI assistant is declared as part of your NixOS configuration, ensuring reproducibility and easy setup on new machines.
Use Cases
- Run an AI coding assistant over SSH on a remote dev server without an IDE.
- Work inside tmux panes alongside your editor and shell, all in the terminal.
- Swap between GPT-4o, Claude Sonnet, and a local Llama model in the same session.
- Use LSP integration to get code diagnostics and inline completions in the terminal.
- Execute shell commands via the assistant with approval gates for safety.
- Define custom agents for specialized tasks using .agents folder.
Models Under the Hood
as of 2026-07-14
Limitations
- TUI has inherent UI limits — reviewing a 500-line diff or a visual design spec is awkward compared to an IDE.
- Younger project than Aider or Claude Code — expect rough edges on the long tail of commands.
- Shell execution requires careful approval-gate setup for safety.
- No centralized team management or usage dashboards.
as of 2026-07-02
Where the pricing makes sense
The company stage and team size where Crush's pricing actually pencils out — and where peers do it cheaper.
Crush is completely free and open-source with no subscription tiers. You only pay for API usage with your chosen LLM providers. This makes it ideal for budget-conscious individual developers, but teams may need to manage billing through their provider accounts.
Setup time & first value
How long it actually takes to get something useful out of Crush — broken out by persona, not the marketing-page minute.
Installation via Homebrew takes under 2 minutes, plus 5 minutes to configure API keys via environment variables. First useful interaction achievable within 10 minutes. NixOS setup via NUR takes longer (flake import), about 20 minutes if familiar with Nix.
Switching to or from Crush
How to bring data in from common predecessors and how to get it back out — written for the switcher, not the buyer.
- →From GitHub Copilot CLI: Install Crush, configure the same API keys you already use for other tools, and you'll get multi-model flexibility that Copilot CLI does not offer.
- →From Aider: Crush offers a similar terminal experience but adds LSP integration and MCP extensibility; you can export Aider sessions by replaying commands manually.
- ↗To Aider: Export your Crush session history (logged in terminal), then adapt your workflows to Aider's command set.
- ↗To Claude Code: Copy your project context and API usage patterns; Claude Code provides a similar terminal-based assistant with Anthropic focus.
Integrations
Resources & Guides
- Resourcegithub.com
GitHub - charmbracelet/crush: Glamourous agentic coding for all 💘
Glamourous agentic coding for all 💘. Contribute to charmbracelet/crush development by creating an account on GitHub.
- Resourcegithub.com
crush/README.md at main · charmbracelet/crush
Glamourous agentic coding for all 💘. Contribute to charmbracelet/crush development by creating an account on GitHub.
Tutorials & Learning
Official links
Tools that pair well with Crush
Common stack mates teams adopt alongside Crush, with the specific reason each pairing earns its keep.
Alternatives to Crush
View allFrequently Asked Questions
Categories
Best-of guides
Used Crush? Help shape our editorial sentiment research.


