Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

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.

Terminal coding agents Terminal agentProprietaryFree to start

Use it in: CLI Works with: MCP Local models Own API key Headless / CI

Price
Free
free tier available
Popularity
#20 in Terminal
Gid Score 41 / 100 · #81 of 251 ranked AI agents
Trend
Growing fast
downloads up 71.9% over 30 days · down 31.1% last week
Development
Actively updated
latest 0.101.0, 8d ago
Community
29.1K GitHub stars
11.3K package downloads a week

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

MakerCharm
TypeTerminal agent
First releasedJuly 2025
LicenseFSL-1.1-MIT
InterfacesCLI
PlatformsmacOS, Linux, Windows
ModelsMany LLMs via OpenAI- or Anthropic-compatible APIs; switch models mid-session
Local modelsAuto-discovers Ollama, LM Studio and llama.cpp servers (docs)
Bring your own API keyYes
Main languageGo
Open issues and PRs552

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.

Compare prices of all agents

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

Full monthly summary

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

npmnpm install -g @charmland/crush

These commands use the packages tracked on this page. The vendor may recommend a different installer; see the official documentation.

Compare Crush with another agent

vs
# 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 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 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

All AI agent news

  1. Release GitHub Releases

    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

0.101.0
  • 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)
0.100.0
  • 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
0.99.0
  • 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.
0.98.2
  • 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)
0.98.1
  • 8584922dc75b0911bf5dea2cbaec64af557f7a45: fix: route newer Copilot models through the Responses API (@DaVinci42)
0.98.0
  • 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

Token prices of Anthropic modelsnewest Anthropic model in each family, output price per 1M tokens
Anthropic OpusAnthropic SonnetAnthropic Haiku

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.

Downloads per daynpm, 7-day average 1,609/day
GitHub starsrunning total 29.1K

Download the raw daily series: crush.csv

Gid Score breakdown

Adoption24
Community61
Attention—
Momentum86

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

NumberLatest readingLast checked
Package downloadsNov 17, 2026Nov 19, 06:19 UTC
GitHub starsNov 19, 2026Nov 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:

AgentGid: #20 in Terminal Gid Score: 41/100 downloads: 11.3K/week ▲72% 30d

[![AgentGid: #20 in Terminal](https://agentgid.com/badges/crush-rank.svg)](https://agentgid.com/agents/crush/)
[![Gid Score: 41/100](https://agentgid.com/badges/crush-score.svg)](https://agentgid.com/agents/crush/)
[![downloads: 11.3K/week ▲72% 30d](https://agentgid.com/badges/crush-downloads.svg)](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.