Crush Agentic AI Coding CLI by Charmbracelet
Crush is a terminal-native AI coding agent built by Charmbracelet that connects your code, tools, and workflows to any LLM. It supports multi-model switching mid-session, MCP extensibility, and LSP-enhanced context across every major platform.
Crush is a terminal-native AI coding agent built by Charmbracelet that connects your code, tools, and workflows to any LLM. It supports multi-model switching mid-session, MCP extensibility, and LSP-enhanced context across every major platform.
npx skills add agentskillexchange/skills --skill crush-agentic-ai-coding-cli-charmbracelet
What is Crush?
Crush is an agentic AI coding assistant designed to run in your terminal. Built by Charmbracelet — the team behind Glow, Bubble Tea, and other popular terminal tools — Crush connects your code, tools, and workflows directly to the LLM of your choice. It replaces the archived Mods project with a full-featured agent that understands your codebase through LSP integration and can be extended via Model Context Protocol (MCP) servers.
How It Works
Install Crush via Homebrew, npm, Winget, or package managers for Arch, Nix, Debian, and Fedora. Run crush in your terminal to start an interactive session. Crush maintains session-based context per project, so switching between repos preserves conversation history. You can configure multiple LLM providers (OpenAI, Anthropic, local models via OpenAI-compatible APIs) and switch between them mid-conversation without losing context.
Key Capabilities
Crush reads your codebase through Language Server Protocol (LSP) support — the same mechanism your editor uses for autocompletion and type checking. This gives the LLM real structural understanding of your code rather than just raw text. You can extend Crush with MCP servers over HTTP, stdio, or SSE transports, adding capabilities like database access, documentation lookup, or custom tooling. The tool runs natively on macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, and NetBSD.
Non-Interactive Mode
Beyond the interactive TUI, Crush provides crush run for pipeline integration. Pipe command output or file contents into Crush for formatting, analysis, or transformation — similar to the workflow the now-archived Mods project provided, but with the added context of the full agent runtime.
Integration Points
Crush integrates with any OpenAI-compatible or Anthropic-compatible API endpoint. It supports MCP for tool extensibility, LSP for code understanding, and standard Unix pipes for non-interactive workflows. Session state persists between runs, making it practical for ongoing development work across multiple projects.