Crush by Charmbracelet: A Claude Code Alternative for Terminal-Native Coding

Crush is an open-source CLI coding agent developed by Charmbracelet, released under the FSL-1.1-MIT license. It runs entirely in the terminal with a polished TUI (terminal user interface), supports any LLM via OpenAI- or Anthropic-compatible APIs, and integrates LSPs and MCPs for deep code understanding. As a Claude Code alternative, Crush is best suited for developers who prefer terminal-first workflows and want full model flexibility — including bringing their own API keys for any provider.

Crush vs. Claude Code: Quick Comparison

Key Strengths

• Full model flexibility (BYOK): Crush is model-agnostic. You connect any LLM that exposes an OpenAI- or Anthropic-compatible API, including Ollama, LM Studio, or any hosted provider. You can even switch models mid-session while preserving the conversation context — something Claude Code, locked to Anthropic models, cannot do.
• LSP integration for deep code context: Crush uses Language Server Protocol (LSP) clients internally, the same mechanism that powers IDE autocomplete and diagnostics. This gives the agent real-time awareness of your project's type system, imports, and symbols — not just raw file text.
• MCP extensibility: Crush supports Model Context Protocol (MCP) over HTTP, stdio, and SSE transports. Developers can wire in external tools, databases, or APIs as MCP servers, making Crush's capabilities extendable without modifying the core application.
• Cross-platform with first-class terminal support: Crush runs on macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, and NetBSD. It is installable via Homebrew, npm, apt, Winget, Scoop, Nix, and package managers for BSD variants. Built on the Charm ecosystem, which powers 25,000+ applications in production.

Known Limitations

• No built-in GUI or editor integration: Crush is purely a TUI application — there is no VS Code extension, JetBrains plugin, or browser-based interface. Developers who prefer a graphical IDE with inline AI suggestions will need a different tool.
• Requires API key management: Because Crush is a bring-your-own-key product, you are responsible for provisioning and managing API keys for your chosen LLM provider. There is no built-in free model tier — you always pay the provider's API rates for cloud models.
• FSL-1.1-MIT license restrictions: The FSL (Functional Source License) allows free use but includes commercial restrictions for competing SaaS products during a time-limited exclusivity window. Teams building commercial coding tools should review the license terms before embedding Crush.

Best For

Crush is best suited for developers who live in the terminal and want a polished CLI coding agent without being tied to a single LLM vendor. It is especially valuable for teams that want to use local or self-hosted models for privacy or cost reasons. Polyglot developers working across multiple languages benefit from Crush's LSP integration, which provides genuine code intelligence across stacks. Power users building custom agent workflows will appreciate the MCP extensibility layer.

Pricing

• Open source: Free to download and use. Source available at GitHub under FSL-1.1-MIT.
• Model costs: You pay your chosen LLM provider's API rates directly. Crush itself does not charge.

Check the official GitHub repository for the latest release and installation instructions.

Tech Details

• Type: CLI Agent / TUI
• Platform: macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, NetBSD
• Key features: Multi-model BYOK, LSP integration, MCP support (HTTP/stdio/SSE), session-based context, mid-session model switching, cross-platform terminal UI
• Privacy / hosting: Local TUI application; model API calls go to your configured provider (cloud or local)
• Models / context window: Any model with an OpenAI- or Anthropic-compatible API. Context window depends on the model you configure.
• License: FSL-1.1-MIT (open source)
• Install: Homebrew, npm (@charmland/crush), apt, Winget, Scoop, Nix, FreeBSD pkg

When to Choose This Over Claude Code

• You want to use models other than Claude — including open-weight local models — without changing tools.
• You need deep code intelligence through LSP integration, not just file-level context.
• You want an open-source, auditable CLI agent you can extend via MCP.
• You work across diverse platforms including Android, BSD variants, or environments where installing a GUI IDE is impractical.

When Claude Code May Be a Better Fit

• You want a fully managed service with a single subscription and no API key setup — Claude Code handles authentication through Anthropic's platform.
• You want the best performance on Anthropic's Claude models specifically, which are the native environment for Claude Code's agentic behaviors.
• You need a tool with an official enterprise support tier and SLA, which Claude Code offers through Anthropic and Cursor enterprise plans.

Conclusion

Crush is the right Claude Code alternative for developers who want a polished, terminal-native coding agent without vendor lock-in. Its BYOK model, LSP integration, and MCP extensibility make it one of the most flexible open-source CLI agents available. Teams prioritizing model flexibility, local LLM usage, or privacy will find Crush a compelling option.

Sources

• Official GitHub Repository — charmbracelet/crush
• Charmbracelet — charm.sh

FAQ