Welcome to Crush
A terminal-based AI coding assistant that connects to LLMs and gives them tools to read, write, and execute code
Why Crush?
Crush is your AI-powered coding companion that lives right in your terminal. Built by Charm, it combines the power of modern LLMs with a beautiful terminal interface and deep code intelligence.Multi-Model Support
Choose from Anthropic, OpenAI, Gemini, Bedrock, and many more
Session-Based
Maintain multiple work sessions and contexts per project
LSP-Enhanced
Crush uses Language Server Protocols for additional context
Extensible
Add capabilities via MCP servers and Agent Skills
Get Started in Minutes
Install Crush
Get Crush installed on your system using your preferred package managerView all installation methods →
Configure Your Provider
Set up your API key for your preferred LLM providerCrush will prompt you for your API key on first run if not set.Learn about providers →
Start Coding
Key Features
Cross-Platform
Works everywhere: macOS, Linux, Windows, Android, FreeBSD, OpenBSD, and NetBSD
Flexible Model Switching
Switch LLMs mid-session while preserving context
Industrial Grade
Built on the Charm ecosystem, powering 25k+ applications
Popular Use Cases
Code Review and Refactoring
Code Review and Refactoring
Use Crush to analyze your codebase, suggest improvements, and refactor code with LSP-powered intelligence
Bug Fixing and Debugging
Bug Fixing and Debugging
Leverage Crush’s understanding of your project structure to identify and fix bugs faster
Feature Development
Feature Development
Build new features with AI assistance that understands your codebase, coding style, and project conventions
Documentation Generation
Documentation Generation
Generate comprehensive documentation that’s tailored to your code and project structure
Ready to Get Started?
Quick Start Guide
Get up and running with Crush in under 5 minutes
Configuration Guide
Customize Crush to fit your workflow
CLI Reference
Explore all available commands and options
Tools Reference
Learn about Crush’s built-in tools
Productivity may increase when using Crush and you may find yourself nerd sniped when first using the application. If the symptoms persist, join the Discord and nerd snipe the rest of us.