GitHub

Crush

Crush is a terminal-based coding agent that wires your tools, code, and workflows into your LLM of choice.

Note

This document was designed for both humans and agents.

Your new coding bestie, now available in your favourite terminal. Your tools, your code, and your workflows, wired into your LLM of choice.

Crush demo

Features

  • Multi-Model: choose from a wide range of LLMs or add your own via OpenAI-compatible or Anthropic-compatible APIs

  • Flexible: switch LLMs mid-session while preserving context

  • Session-Based: maintain multiple work sessions and contexts per project

  • LSP-Enhanced: Crush uses LSPs for additional context, just like you do

  • Extensible: add capabilities via MCPs (http, stdio, and sse)

  • Works Everywhere: first-class support in every terminal on macOS, Linux, Windows (PowerShell and WSL), Android, FreeBSD, OpenBSD, and NetBSD

  • Industrial Grade: built on the Charm ecosystem, powering 25k+ applications, from leading open source projects to business-critical infrastructure

Installation

Crush ships as a single binary and installs just about everywhere. brew, npm, winget, Nix, FreeBSD, you name it. Pick your poison in Installation, then run crush and pick your provider.

Contributing

See the contributing guide.

Whatcha think?

We'd love to hear your thoughts on this project. Need help? We gotchu. You can find us on:

License

Crush is released under the FSL-1.1-MIT license.

Read this post in your terminal with glow:glow -p https://crush-docs.fly.dev/index.md

EOF