---
slug: "crush"
name: "Crush"
effect: "Runs a terminal coding agent from Charm that works with your choice of LLM and uses LSPs for context"
category: "coding-agent"
tier: "rising"
url: "https://github.com/charmbracelet/crush"
github: "charmbracelet/crush"
pricing: "free"
license: "FSL-1.1-MIT (source-available; each version becomes MIT two years after release)"
tags: ["cli", "terminal", "tui", "mcp", "lsp"]
platforms: ["macos", "linux", "windows"]
install_kind: "npm"
date_added: "2026-10-14"
rank: 20
rising_score: 42
stars: 28644
star_velocity: 56
velocity_basis: "since creation"
created_at: "2025-05-21T12:14:57Z"
pushed_at: "2026-10-15T00:50:57Z"
signals_status: "ok"
signals_fetched_at: "2026-10-15T05:02:40.176Z"
page: "https://agenttooldrop.com/tools/crush"
---

# Crush

Runs a terminal coding agent from Charm that works with your choice of LLM and uses LSPs for context

Category: Coding agents. Tier: new and rising, rank 20 by new and rising score (42 of 100). Pricing: Free. License: FSL-1.1-MIT (source-available; each version becomes MIT two years after release).

Platforms: macos, linux, windows.

## Why you would want it

Crush lets you pick from many LLM providers, or add your own through OpenAI- or Anthropic-compatible APIs and local runtimes such as Ollama and LM Studio, and switch models mid-session without losing context. It keeps multiple sessions per project, pulls extra context from language servers, and extends through MCP servers over http, stdio and sse, plus agent skills and hooks. It runs in terminals on macOS, Linux, Windows, Android, FreeBSD, OpenBSD and NetBSD.

## Best for

- Terminal users on any OS, including the BSDs
- Switching models mid-session
- LSP-aware context for the agent

## Use it when

You want a terminal agent that is not tied to one model vendor and can use the language servers you already run.

## Skip it if

You need an OSI open-source license: Crush uses FSL-1.1-MIT, which bars competing commercial use until a version converts to MIT after two years.

## Install

Install with npm:

```sh
npm install -g @charmland/crush
```

Source: https://github.com/charmbracelet/crush#readme

## Live signals

Fetched 2026-10-15T05:02:40.176Z (status: ok).

- Repository: charmbracelet/crush
- Repository created: 2025-05-21
- Stars: 28,644 (GitHub's count; it cannot be authenticated)
- Stars per day, since repo creation: 56 (an average over the repo's life, not a growth rate)
- Forks: 2,337
- Open issues and PRs: 856
- License (GitHub): NOASSERTION
- Last push: 2026-10-15
- Latest release: v0.98.1 (2026-10-09)

## Links

- Website: https://github.com/charmbracelet/crush
- GitHub: https://github.com/charmbracelet/crush
- Install instructions verified at: https://github.com/charmbracelet/crush#readme
- Source for this entry: https://github.com/charmbracelet/crush#readme
- AgentToolDrop page: https://agenttooldrop.com/tools/crush
- Full catalog (JSON): https://agenttooldrop.com/tools.json