Reviewed by Harsh Desai · Last reviewed:
Crush
A terminal-native AI agent framework for automating coding tasks from your command line
Best for
Crush is a free, open-source a terminal-based AI agent framework from Charmbracelet. It runs entirely in your command line and executes multi-step coding tasks autonomously -- planning, running tools, and reporting results while you stay in the terminal.
Features:
- •Skill-based task automation Crush organizes agentic workflows around reusable skills, so you can automate repetitive terminal tasks without writing shell scripts from scratch.
- •Agentic execution loops give Crush a task and it plans the steps, calls tools, runs commands, and reports back. You approve or adjust via desktop notifications.
- •MCP support Crush integrates with the MCP ecosystem, letting your agent connect to external tools and data sources through standardized protocol servers.
- •Desktop notification feedback when the agent needs permission for a tool call or file edit, Crush sends a native desktop notification so you stay in control without switching windows.
- •API available Crush exposes an API for programmatic integration, letting you trigger agent runs from scripts, CI pipelines, or other automation tools.
- •CLI-native design built by Charmbracelet, the team behind Bubble Tea and Lip Gloss, so the terminal UI is polished, keyboard-driven, and fast.
- •GitHub repository the project has 23,733 GitHub stars and is actively maintained with regular releases on the Charmbracelet GitHub.
Pricing:
- •Free Crush is completely free to use. No paid tiers, no subscription, no usage limits. Download and run it from the Charmbracelet GitHub repository.
Limitations:
- •Requires terminal proficiency Crush is a CLI tool. If you are not comfortable navigating a terminal, installing packages, and reading command output, the learning curve is steep. No GUI fallback exists.
- •No graphical interface everything happens in the terminal. There is no visual editor, no file tree, no drag-and-drop. Developers who prefer IDE-based workflows may find this limiting for complex projects.
- •No mobile or web app Crush runs on desktop operating systems only. You cannot monitor or trigger agent tasks from a phone or browser, which limits use for on-the-go workflows.
- •Agent quality depends on the LLM Crush orchestrates agentic steps but relies on the connected language model for reasoning. Complex multi-step tasks can fail if the model misinterprets context or hallucinates tool calls.
- •Sparse documentation as a newer open-source project, official docs are limited. Users often rely on GitHub issues and community discussion to troubleshoot setup and advanced configurations.
Our Verdict
Crush is a strong choice for developers who want agentic automation without leaving the terminal. It scores 8.3/10. Its skill-based workflows and notification-driven permission model keep you in control while the agent handles repetitive tasks. The main caveat is that it demands real terminal comfort -- this is not a point-and-click tool.
For the Vibe Builder, Crush offers a way to automate multi-step terminal tasks through skill-based workflows without writing complex shell scripts. The desktop notification system means you can monitor agent progress in real time. However, you still need basic CLI familiarity to set it up and manage configurations.
For the Developer, Crush delivers exactly what it promises -- agentic task execution right inside your terminal. The MCP support makes it easy to integrate into existing workflows. Charmbracelet's CLI design pedigree shows in the polished interface. The trade-off is limited documentation and the inherent unpredictability of agentic task chains.
Skip it if you need a full IDE experience with visual debugging and inline code suggestions -- consider using Cursor or VS Code with GitHub Copilot. Skip it if you have zero terminal experience and want a graphical interface for AI-assisted coding.
Related Tools
View allCompare Crush With
Also Useful For
Frequently Asked Questions
Is Crush free to use?
Yes, Crush is completely free. It is an open-source project hosted on GitHub by Charmbracelet with no paid tiers, subscriptions, or usage limits as of 2026. This evaluation is based on hands-on testing and comparison with similar tools in the same category, updated for 2026.
Should I choose Crush or Cursor?
Choose Crush if you live in the terminal and want agentic automation for CLI tasks. Choose Cursor if you need a full-featured IDE with integrated AI code completion, visual debugging, and a graphical interface.
How does Crush handle agent permissions?
Crush sends native desktop notifications when the agent requires permission for a tool call or file modification. You approve or deny actions directly from the notification without switching context. This evaluation is based on hands-on testing and comparison with similar tools in the same category, updated for 2026.
What makes Crush unique compared to other AI coding tools?
Crush is built by Charmbracelet, the team behind popular terminal UI libraries. Its deep CLI integration, skill-based automation, and keyboard-driven interface create a terminal-native agentic experience unlike IDE-based alternatives. This evaluation is based on hands-on testing and comparison with similar tools in the same category, updated for 2026.
Is Crush suitable for non-technical users?
No. Crush is designed for developers and automation enthusiasts comfortable with terminal interfaces. Non-technical users should consider GUI-based tools like Cursor or Lovable instead. This evaluation is based on hands-on testing and comparison with similar tools in the same category, updated for 2026.
What is Crush?
Crush is A terminal-native AI agent framework for automating coding tasks from your command line.
Who should use Crush?
Crush is built for vibe builders who want AI to handle the technical work and developers looking to accelerate their workflow. Common use cases include Automated Code Refactoring, Terminal Workflow Automation, Autonomous Bug Fixing, Command Line Scripting, Multi Step Task Execution.
What are the best alternatives to Crush?
Popular alternatives to Crush include Claude Code, Cursor, Windsurf. Compare features and pricing in our Coding directory to compare options.
Affiliate link: we may earn a commission. How this works.
Crush
Free tier available