- 2b7816fed084f029f4061e441a6f9f3980e71c21: feat(skill): toggle skills (@BrunoKrugel)
- 7f9e4824c465e1ffa1a1d652dd6e9a897b54035c: feat(ui): Add elapsed time on tool call (@BrunoKrugel)
- f38c0dc030912cc3eeaa82cfb014cf21868405b0: feat: add CRUSH_DATA_DIR env var to override the project data directory (@andreynering)
- ebca1dc9328ad91946f25c9bf5a90d6ce8118d6b: feat: persist model display name on messages (@andreynering)
- fedf5b82b392d2e02226b196c83f593c03d27803: feat: pipe question tools (@andrinoff)
- c0f19dfff04ee91606a472ce0f870053c033b6b4: fix(agent): stop a cancelled or silent stream instead of hanging the turn (@taciturnaxolotl)
Crush by Charm
Charm's terminal-based AI coding agent (TUI) that connects to many LLMs through OpenAI- and Anthropic-compatible APIs and supports LSP and MCP. Its source is public under the FSL-1.1-MIT license, which is source-available rather than OSI open source.
Use it in: CLI Works with: MCP Local models Own API key Headless / CI
On this page
Usage data: latest readings Nov 17 to Nov 19, 2026, last checked Nov 19, 06:26 UTC. Date of each number
What Crush does
Crush is a terminal agent from Charm, first released in July 2025. You use it through a command-line tool on macOS, Linux and Windows. Its documentation covers MCP servers, a non-interactive mode for scripts and CI, your own API key and local models. It can run models from Anthropic, OpenAI, Google, Qwen, Moonshot (Kimi) and Amazon Bedrock and others. It has a free tier.
Key facts
| Maker | Charm |
|---|---|
| Type | Terminal agent |
| First released | July 2025 |
| License | FSL-1.1-MIT |
| Interfaces | CLI |
| Platforms | macOS, Linux, Windows |
| Models | Many LLMs via OpenAI- or Anthropic-compatible APIs; switch models mid-session |
| Local models | Auto-discovers Ollama, LM Studio and llama.cpp servers (docs) |
| Bring your own API key | Yes |
| Main language | Go |
| Open issues and PRs | 552 |
Pricing
Crush is free to use with the user's own provider API keys; no Charm pricing page found.
Checked Nov 5, 2026. Prices change often; confirm before you buy.
Quick answers
- Free to start?Yes
- Open source?No
- Works with local models?Yes
- Bring your own API key?Yes
- Runs onmacOS, Linux, Windows
- Where you use itCLI
- Supports MCP?Yes
- Model providersanthropic, openai, google, qwen, moonshot, amazon, openrouter, any OpenAI-compatible, local
- Runs in scripts / CI?Yes
- Feature comparisonAll agents
- Closest alternativeClaude Code · all alternatives
What's new in Crush: November 2026 so far
November brought expanded control over agent permissions and capabilities, along with improvements to sub-agent handling and tool execution. New features make it easier to manage what commands agents can run and how they interact with each other.
- New permission system with safe, block, and unblock commands to control which operations agents can perform.
- Agents can now dispatch and message sub-agents mid-run, and move them between different models.
- Skills can be toggled on and off, and tool calls now display elapsed time in the UI.
- Read-only bash command chains are now evaluated by their individual parts for better safety.
2 releases this month · summarised from the official release notes · all months
Get started with Crush
Project instructions file for Crush: where it goes, format and a template →
| npm | npm install -g @charmland/crush |
|---|
These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.
Crush alternatives
Best Crush alternatives compared · All terminal coding agents
| # | Agent | Gid Score | Downloads 7d | 7d | 30d | Stars | Latest release | Price | |||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 |
Claude CodeAnthropic |
88 | 18.9M | up 15.1% | up 15.5% | 156K+136/day | 2.1.328yesterday | $20/mo | |||
| 2 |
OpenAI CodexOpenAI |
84 | 26.6M | up 2.4% | up 7.4% | 136K+144/day | 0.168.07d ago | Free + $8/mo | |||
| 3 |
OpenCodeAnomaly (SST team) |
80 | 3.9M | up 15.4% | up 28.7% | 228K+266/day | 2.3.22d ago | Free + $10/mo | |||
| 7 |
PiEarendil Inc. (created by Mario Zechner) |
73 | 6.4M | up 1.6% | up 36.3% | 123K+193/day | 1.5.210d ago | Free (OSS) | |||
| 15 |
Gemini CLIGoogle |
62 | 495K | up 16.9% | up 6.8% | 109K+35/day | 0.69.0yesterday | API usage or license | |||
| 20 |
ClineCline Bot Inc. |
58 | 84.3K | down 8.7% | up 14.9% | 71.8K+38/day | 4.1.2625d ago | Free + $9.99/mo | |||
Ratings from people who use Crush
No ratings yet. Used Crush? Rate it and say what it is good and bad at.
Crush news
-
Crush 0.101.0 released
2b7816fed084f029f4061e441a6f9f3980e71c21: feat(skill): toggle skills (@BrunoKrugel); 7f9e4824c465e1ffa1a1d652dd6e9a897b54035c: feat(ui): Add elapsed time on tool call (@BrunoKrugel); f38c0dc030912cc3eeaa82cfb014cf21868405b0: feat: add CRUSH_DATA_DIR env var…
What changed: recent Crush releases
18 stable releases in the last 90 days · Monthly summary · Full changelog
- permissions safe marks commands safe for yolo
- permissions block blocks commands completely
- permissions unblock unblocks restricted commands
- 965d1a794bbe5c01c2f0e5b62293791060d81622: feat(agent): dispatch detached sub-agents and message them mid-run (@taciturnaxolotl)
- 938fef205ca1ba6a35d5ff9f93e69b5c31d41a83: feat(agent): let agent_send move a subagent to a different model (@taciturnaxolotl)
- f7179d1624643b84fb350528c85d86407541ac6e: feat(bash): judge a chain of read-only commands by its parts (@taciturnaxolotl)
Earlier releases
- Host themes: the host app can theme the TUI over the server API, so Crush matches your applications.
- Host context: the host can tell Crush what's in view, like open files, and those files appear in completions.
- Append to the next prompt: clients can add text the agent reads with the next prompt, without starting a run or cluttering the chat.
- Shared viewing: clients can see which session other clients are looking at.
- Piped permissions: set CRUSH_PERMISSIONS_PIPED=1 and the host answers permission prompts, so you aren't asked twice.
- addresses work as an alias for tcp:// when starting the server.
- cd5f15d366f516c992ec8331f0bc158708bb69ec: feat(openrouter): send app attribution headers and session_id for sticky routing (@Lee-Si-Yoon)
- a8a8ec8aaeef8464ede0461407621f1e081a29c1: feat: add a built-in keanu theme (@andreynering)
- 78b6edb353f3fb11178c7e38bbac762772dfb8b0: feat: publish optional signed Packslip release manifests (@jdx)
- 20e73b45baaff59bf192887e177a90e9927ba40c: fix(agent): ask every OAuth sign-in to sign in again on a 401 (@taciturnaxolotl)
- 02336b1a678d2cece3a7b89cef2c5379ece63dd2: fix(agent): give sub-agents the renewed credential after a refresh (@taciturnaxolotl)
- acbf1a717c16a47c86d2277bcf3ebff8b91edd85: fix(agent): prevent crash when parallel tool calls finish together (@andreynering)
- 8584922dc75b0911bf5dea2cbaec64af557f7a45: fix: route newer Copilot models through the Responses API (@DaVinci42)
- Server side improvements
- External editor swallowing empty buffer
- Models behind OAuth couldn't be used if they weren't in Catwalk
- Fixed MCP toggled misbehavior
- 19e7dd4e9df41fcad81082de3471004cde4ab606: feat: OSC 7501 (@andrinoff)
- 30145cbc8fbb1b33eeeaafb527328474eb20e093: feat: grok OAuth (@andrinoff)
Crush prices over time
Crush popularity and usage data
Crush was downloaded 11.3K times from npm in the week ending Nov 17, 2026, down 31.1% on the week before and up 71.9% over the last 30 days compared with the 30 before. The GitHub repository has 29.1K stars, 540 of them added in the last 30 days. The latest stable release is 0.101.0, published Nov 12, 2026; there were 4 stable releases in the past 30 days.
Download the raw daily series: crush.csv
Gid Score breakdown
Gid Score shows public popularity and activity (usage, GitHub stars, mentions, growth), not the quality of the product. Each component is scored 0 to 100 from public signals; a dash means no data for it. How the Gid Score works.
How fresh these numbers are
| Number | Latest reading | Last checked |
|---|---|---|
| Package downloads | Nov 17, 2026 | Nov 19, 06:19 UTC |
| GitHub stars | Nov 19, 2026 | Nov 19, 06:26 UTC |
We fetch every source once a day. Registries publish downloads and page views a day or two late, so their latest reading trails the check. A reading more than 4 days old is marked out of date; the Gid Score still uses it until a newer one arrives.
Crush FAQ
How much does Crush cost?
Crush is free to use with the user's own provider API keys; no Charm pricing page found.
Is Crush open source?
No. Crush is a proprietary product from Charm.
How popular is Crush?
Crush was downloaded 11.3K times from npm in the week ending Nov 17, 2026, down 31.1% on the week before and up 71.9% over the last 30 days compared with the 30 before. The GitHub repository has 29.1K stars, 540 of them added in the last 30 days. The latest stable release is 0.101.0, published Nov 12, 2026; there were 4 stable releases in the past 30 days.
What is the latest version of Crush?
The latest stable release we track is 0.101.0, published on Nov 12, 2026.
What are the alternatives to Crush?
The closest alternatives in the same category by Gid Score are Claude Code, OpenAI Codex, OpenCode, Pi.
For the makers of Crush badges, corrections
Add a live badge to your README or site:
[](https://agentgid.com/agents/crush/)
[](https://agentgid.com/agents/crush/)
[](https://agentgid.com/agents/crush/)
Something wrong or outdated on this page? Send a correction with a link to the official source. More for makers.
Where these numbers come from
npm: @charmland/crush. GitHub: charmbracelet/crush. See data sources for how each one is collected.
Product facts and pricing were checked against: github.com, charm.land, registry.npmjs.org.