Crush ist ein KI-Coding-Agent für das Terminal von Charmbracelet, Inc. (Charm). Als AI Harness verbindet Crush ein frei wählbares Sprachmodell mit Dateien, Shell, Sprachservern (LSP) und MCP-Werkzeugen und läuft auf macOS, Linux, Windows und BSD. Der Quellcode ist öffentlich, steht aber unter der Source-available-Lizenz FSL-1.1-MIT. Stand: 22. November 2026.
Was ist Crush?
Crush ist der Terminal-Agent von Charm für Softwareentwicklung und angrenzende Aufgaben, geschrieben in Go und gebaut auf Charms eigenen Terminal-Bibliotheken wie Bubble Tea. Das Projekt setzt das frühere Go-Projekt opencode-ai/opencode fort: Dessen archiviertes Repository verweist laut README auf Crush als Fortsetzung durch den ursprünglichen Autor und das Charm-Team. Mit dem heutigen OpenCode von Anomaly, einem eigenständigen und überwiegend in TypeScript geschriebenen Projekt, ist Crush nicht identisch.
Laut GitHub-API hat charmbracelet/crush 29.163 Sterne. Die erste Version 0.1.0 wurde am 29. Juli 2025 getaggt, aktuell ist laut Releases Version 0.102.0 vom 19. November 2026 (Stand: 22. November 2026); zwischen dem 29. Oktober und dem 19. November 2026 erschien jede Woche eine neue Minor-Version. Installiert wird Crush unter anderem mit brew install charmbracelet/tap/crush, npm install -g @charmland/crush, Winget, Scoop, den Paketquellen von Charm für Debian und Fedora oder go install. Laut README läuft Crush auf macOS, Linux, Windows (PowerShell und WSL), Android, FreeBSD, OpenBSD und NetBSD.
Ist Crush Open Source? Lizenz und Kosten
Nicht im Sinne der Open Source Initiative. Crush steht laut LICENSE.md unter der Functional Source License 1.1 mit MIT-Zukunftslizenz (FSL-1.1-MIT); GitHub erkennt diese Lizenz nicht automatisch und meldet NOASSERTION. Die FSL erlaubt Nutzung, Änderung und Weitergabe für jeden Zweck außer einer „Competing Use“, also einem kommerziellen Produkt oder Dienst, der Crush ersetzt oder gleiche Funktionen anbietet. Ausdrücklich erlaubt sind interne Nutzung, nicht kommerzielle Lehre und Forschung sowie Dienstleistungen für Lizenznehmer. Weil die Lizenz damit bestimmte Einsatzzwecke ausschließt, ist Crush Source-available und keine Open-Source-Software nach OSI-Definition.
Laut fsl.software ist die FSL eine Fair-Source-Lizenz, die für jede veröffentlichte Version nach zwei Jahren in eine permissive Lizenz übergeht. Bei Crush ist das MIT: Die ersten FSL-Versionen vom Juli 2025 werden damit ab Juli 2027 unter MIT nutzbar. Code des ursprünglichen Autors Kujtim Hoxha aus der Zeit bis 30. Mai 2025 steht laut Lizenzdatei weiterhin unter MIT. Für Unternehmen heißt das: Den Agenten intern einzusetzen erlaubt der Lizenztext ausdrücklich, ein eigenes kommerzielles Coding-Agent-Produkt auf Basis von Crush dagegen nicht. Crush selbst ist kostenlos; Kosten entstehen bei den Modell-Providern oder bei Charms Inferenzdienst Hyper.
Crush als AI Harness
Crush deckt die Bausteine eines Harness selbst ab und setzt einen Schwerpunkt auf Sprachserver. Laut README nutzt Crush LSPs als zusätzlichen Kontext, und laut Konfigurationsschema richtet es passende Sprachserver standardmäßig anhand typischer Projektdateien ein. Werkzeuge für Diagnosen, Referenzen, Definitionen und Umbenennungen greifen darauf zu; das Edit-Werkzeug hängt laut Quellcode nach jeder Änderung die Diagnosen des Sprachservers an sein Ergebnis an. MCP-Server bindet Crush über stdio, HTTP und SSE an, bei Bedarf mit OAuth. Dazu kommen Agent Skills nach offenem Standard und Hooks, deren Format laut Hook-Doku weitgehend Claude Code entspricht.
Die Agentenschleife läuft interaktiv in der Terminal-UI, headless mit crush run für Skripte und Pipes sowie im Client-Server-Modus: crush server stellt eine HTTP-API mit OpenAPI-3.1-Beschreibung bereit, und mehrere Clients im selben Verzeichnis teilen sich Sitzungen, Freigaben, LSP und MCP. Sitzungen speichert Crush je Projekt in einer SQLite-Datenbank unter .crush; --continue oder --session setzen sie fort. Seit Version 0.100.0 vom 5. November 2026 startet Crush Subagenten im Hintergrund, schickt ihnen Nachfragen, stoppt sie oder weist ihnen ein anderes Modell zu. Konfiguriert wird Crush über eine crushrc, ein Bash-Skript mit eigenen Befehlen wie provider add, mcp add oder permissions allow, das dank eingebautem Bash-Interpreter laut README auf allen Plattformen gleich funktioniert.
Modelle und Modellzugang
Crush ist modellunabhängig. Laut README binden Umgebungsvariablen rund 20 Provider an, darunter Anthropic für Claude, OpenAI für GPT, Google für Gemini über die Gemini-API oder Vertex AI, Amazon Bedrock (dort laut README derzeit nur Anthropic-Modelle), Azure OpenAI auch mit Entra ID, OpenRouter, Vercel AI Gateway, Groq, Cerebras und xAI. Per crush login melden Sie sich laut CLI-Hilfe bei Hyper, GitHub Copilot, OpenAI (ChatGPT) oder xAI an. Lokale Modelle aus Ollama, LM Studio, llama.cpp oder LiteLLM erkennt Crush automatisch. Die Modellliste pflegt Charm im offenen Katalog Catwalk, den Crush standardmäßig online aktualisiert; das Modell lässt sich mitten in der Sitzung wechseln, ohne den Kontext zu verlieren.
Den schnellsten Einstieg bietet laut README Charms eigener Inferenzdienst Hyper mit offenen Modellen. Laut Hyper-Doku zu Plänen und Abrechnung kosten Personal-Pläne 10 bis 200 US-Dollar im Monat und sind nicht Zero Data Retention (ZDR); Team-Pläne kosten 30 bis 220 US-Dollar pro Nutzer und Monat und sind wie Prepaid-Guthaben ZDR. Enterprise bietet unter anderem SAML SSO, Ausgabenlimits je Nutzer und Audit-Exporte und nennt US-Inferenz und Datenresidenz in den USA.
Eigene Endpunkte sind laut README zu Custom Providers ausdrücklich vorgesehen: provider add legt einen Provider mit --base-url, --api-key und optional --extra-header an, als Typ completions für OpenAI-kompatible APIs, responses für OpenAI Responses oder messages für Anthropic-kompatible APIs. Mit option default-providers false blendet Crush alle eingebauten Provider aus, sodass nur Ihr eigener Endpunkt bleibt; Modelle tragen Sie dann mit model add selbst ein. Damit lässt sich Crush im Proxy-Modus über das AI Gateway betreiben, das Rechte und Budgets prüft und jeden Token einer Kostenstelle zuordnet.
Einsatz im Unternehmen: Datenschutz und Governance
Crush läuft lokal und sendet Prompts, Dateiinhalte und Werkzeugergebnisse an den gewählten Modell-Provider. Wichtig für den Datenschutz: Die Telemetrie ist standardmäßig aktiv. Laut README zu Metrics erfasst Crush pseudonyme Nutzungsmetriken, gebunden an einen gerätespezifischen Hash; Prompts und Antworten sind laut Hersteller nie enthalten. CRUSH_DISABLE_METRICS=1, DO_NOT_TRACK=1 oder option metrics false schalten das ab. Zusätzlich lädt Crush die Providerliste aus Catwalk; option provider-auto-update false unterbindet das für abgeschottete Umgebungen.
Das Berechtigungsmodell fragt laut README standardmäßig vor Werkzeugaufrufen; nur nachweislich lesende Shell-Befehle wie git status laufen ohne Rückfrage. permissions allow gibt einzelne Werkzeuge frei, permissions deny blendet sie ganz aus. Der Yolo-Modus (-y oder --yolo) überspringt alle Rückfragen und blockiert nur eine Liste gefährlicher Befehle wie curl, ssh, Paketmanager oder systemctl; der Sysadmin-Modus (-yy) erlaubt alles. Diese Liste ist laut Quellcode eine Leitplanke gegen Versehen und ausdrücklich keine Sandbox. Beachten Sie außerdem: crushrc und crush.json gelten laut README als vertrauenswürdiger Code und werden beim Start ausgeführt, und Crush versieht Commits und Pull Requests standardmäßig mit einem Attribution-Trailer.
Eine zentrale Nutzer- oder Policy-Verwaltung für Crush selbst ist nicht dokumentiert. Vorgaben verteilen Sie über eine globale crushrc mit eigenem Provider, abgeschalteten Metriken, permissions-Regeln und Hooks, die gefährliche Befehle deterministisch blockieren. Quellcode und Prompts gehören unabhängig davon ins Verarbeitungsverzeichnis.
Crush mit herdr und Orca betreiben
Crush wird von herdr unterstützt, und zwar vom Agenten selbst: Die Agentenliste von herdr in Version 0.9.5 führt Crush unter „Supported by the agent“, eine Integration müssen Sie nicht installieren. Laut Quellcode meldet Crush seit Version 0.81.0 vom 29. Juni 2026 über den herdr-Socket die Zustände idle, working und blocked samt Session-ID, sobald es in einer herdr-Pane läuft. Einen Befehl zum Fortsetzen der Sitzung nach einem Neustart des herdr-Servers übermittelt Crush laut Quellcode derzeit nicht.
Orca führt „Charm Crush“ laut eigener Agentenübersicht mit automatischer Einrichtung, ohne Statusmeldungen oder Hooks. Orca startet unterstützte Agenten standardmäßig mit ihrem Flag zum Überspringen von Freigaben, bei Crush also mit --yolo; in den Orca-Einstellungen lässt sich diese Vorgabe auf Manual umstellen.
Wie unterscheidet sich Crush von Claude Code und OpenCode?
Crush ist modellunabhängig und liegt als Source-available-Code vor, während Claude Code vom Modellanbieter Anthropic stammt, proprietär ist und auf Claude-Modelle zugeschnitten ist. OpenCode von Anomaly ist ebenfalls modellunabhängig, steht aber unter der MIT-Lizenz, ist überwiegend in TypeScript geschrieben und bietet zusätzlich eine Desktop-App. Typisch für Crush sind die enge LSP-Anbindung, die Konfiguration als Bash-Skript, die breite Plattformunterstützung bis zu Android und BSD sowie die eingebaute Statusmeldung an herdr. Crush und Claude Code fragen in ihrem Standardmodus vor Dateiänderungen und Shell-Befehlen nach. Wer einen modellunabhängigen Agenten mit Desktop-App unter Apache-2.0 sucht, findet ihn in Goose.
Einordnung: Entwickler-Harness und Unternehmens-Harness
Crush ist ein Harness für Entwicklerinnen und Entwickler, die im Terminal arbeiten. Für Fachanwender ohne Kommandozeile ist CompanyGPT der passende Harness mit MCP-Werkzeugen, Unternehmenswissen und Rollen aus Entra ID oder Keycloak. Das AI Gateway bildet die gemeinsame Kosten- und Governance-Schicht; die Agent-Zeit-Messung seines Companions deckt laut Produktseite Claude Code, Codex, OpenCode, Pi, GitHub Copilot CLI und Gemini CLI ab, Crush erfassen Sie über den Proxy-Modus. Weitere Coding-Agenten und Orchestrierer zeigt unsere Übersicht der KI-Harnesses.
