crush - AI Code Assistants Tool

Overview

Crush is an open-source, terminal-first AI coding agent from Charm (charmbracelet) that wires developer workflows, tools, and multi-model LLM providers into an interactive terminal UI. It provides session-based contexts per project, LSP-enhanced code context, and the ability to switch models mid-session while preserving conversation state. According to the project's README, Crush supports OpenAI- and Anthropic-compatible providers, Bedrock and Vertex integrations, and can be extended via MCP servers over stdio, HTTP, or SSE. ([github.com](https://github.com/charmbracelet/crush)) The tool is designed for cross-platform developer use (macOS, Linux, Windows, and BSDs) and emphasizes safe, auditable interactions: it prompts for permission before running tools by default, logs activity, and can add attribution trailers to commits and PRs it creates. Crush also supports the Agent Skills standard to add reusable skill packages and can automatically update its provider/model metadata from the Catwalk provider database. For full technical details and configuration examples, see the project README and releases. ([github.com](https://github.com/charmbracelet/crush))

GitHub Statistics

• Stars: 17,223
• Forks: 1,035
• Contributors: 81
• License: NOASSERTION
• Primary Language: Go
• Last Updated: 2026-01-09T16:28:30Z
• Latest Release: v0.31.0

The repository shows strong community traction—GitHub lists roughly 17.2k stars and ~1k forks, active issue and PR traffic, and a multi-release cadence with binary artifacts (examples: v0.19.1 and v0.21.0 releases). The README and repo layout show the project is written in Go (go.mod, main.go present) and includes tooling for packaging (goreleaser) and platform binaries. Overall activity indicators (frequent releases, 2k+ commits, and an active issues/PR queue) point to active maintenance and a healthy ecosystem of contributors and downstream packaging (Homebrew, apt, RPMs, Nix). ([github.com](https://github.com/charmbracelet/crush))

Installation

Install via brew:

brew install charmbracelet/tap/crush

npm install -g @charmland/crush

go install github.com/charmbracelet/crush@latest

sudo mkdir -p /etc/apt/keyrings && curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg && echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list && sudo apt update && sudo apt install crush

winget install charmbracelet.crush

Key Features

• Multi-model provider support including OpenAI-, Anthropic-compatible APIs and other custom providers.
• Switch LLMs mid-session while preserving conversation and project context.
• LSP integration to surface language-server context (diagnostics, symbols, docs) to the agent.
• Model Context Protocol (MCP) support over stdio, HTTP, and SSE for external retrieval services.
• Sessioned workflows: multiple sessions/contexts per project with initialization-generated AGENTS.md context files.

Community

Crush has attracted a large open-source community (GitHub ~17.2k stars, ~1k forks) and active discussions in issues, PRs, Reddit, and other forums. Users praise the terminal UI and model flexibility but occasionally discuss UX choices and project history in community threads. The project publishes signed releases and packaging for multiple platforms, and developers can join the project's Discord and GitHub discussions for support and feedback. See the repository README and recent release notes for community and release details. ([github.com](https://github.com/charmbracelet/crush))

Key Information

• Category: Code Assistants
• Type: AI Code Assistants Tool