Crush CLI
Charm's terminal coding agent: any model, switching models mid-session, LSP, MCP and Agent Skills
- 28,874 ★ on the repository
- Last commit
Broad access
Why this level
- The agent runs shell commands and edits project files
- Tools can be allowed to run without confirmation
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/crushDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent runs shell commands and edits project files
- Tools can be allowed to run without confirmation
This is third-party code. Review the repository files before installing.
What it does
Crush runs in the terminal and connects to models through OpenAI- or Anthropic-compatible APIs, including local ones via Ollama. You can switch models mid-session without losing context and keep several sessions per project. The agent uses LSP servers for context and extends itself with MCP servers over stdio, http and sse, with OAuth for remote servers. It supports the Agent Skills standard and discovers skills in crush, .agents and .claude folders. Configuration lives in crushrc, a Bash script with built-in commands that behaves the same on Windows.
Who it is for. For developers who want a terminal agent that is not tied to one model provider.
Good fit when
- You want different models, including local ones, in one agent
- You need an agent on Windows, FreeBSD or Android without WSL workarounds
- You already have skills in .claude/skills and want to reuse them
Not a fit when
- You need tight IDE integration rather than a terminal
- The FSL license does not fit your use case
Example request
Figure out why the build fails and propose a fix, and switch to the local modelLimitations
Licensed FSL-1.1-MIT: source is available, but competing commercial use is restricted until a version converts to MIT. You need a model provider key or a Charm Hyper subscription. Without a VPN it works with local models and providers reachable from Russia; OpenAI and Anthropic cloud APIs need a VPN.
How to disable. Uninstall with the package manager you used, for example brew uninstall crush, and remove crushrc files if needed.
FAQ
How do I add an MCP server?
Use mcp add in crushrc with the stdio, http or sse type, a URL or command, and headers.
Can I use a local model?
Yes, add an ollama provider in crushrc with provider add and register a model with model add.
Discussion
No questions or reviews yet.
Related
CLI toolsA Python terminal coding agent in the manner of Claude Code: reads the repository, edits files, runs commands, with memory, sub-agents and MCP
A terminal coding agent that picks a model for each request on its own and shows spend in real time
A Rust SDK for coding agents and the ready-made abstract CLI: REPL, 34 tools, MCP, graph memory, Anthropic and OpenAI, JSON output for CI
Empryo is a coding agent for desktop, terminal and CI that maps your repository, edits code by symbol name and runs its own checks
Context Engine: code search and memory for an agent
Context Engine
A skill that teaches an agent to query the Context Engine code index and symbol graph before reading files directly
MiniCode is a compact TypeScript terminal coding agent like Claude Code: tool loop, TUI, skills, MCP and sub-agents, built for study and tinkering
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| Crush (this entry) | no | 28,874 | |
| Tianshu Harness | no | 1,215 | a coding agent for the terminal and desktop |
| Devo | no | 341 | an open-source coding agent in Rust with a persistent Python workspace |
| Klaat Code | yes | 353 | a terminal coding agent that picks a model for each request on its |
README in short
The README lists installs via Homebrew, npm, winget, scoop, Linux packages, Nix and go install. It covers a quick start with the Hyper provider, adding keys for other providers and configuration through crushrc. It details MCP with OAuth, LSP, tool permissions, file ignores and skill discovery paths. Licensed FSL-1.1-MIT.