# Crush Coding-Agent fürs Terminal von Charm mit vielen Modellanbietern, LSP- und MCP-Anbindung sowie Rückfrage vor Werkzeugaufrufen. Kanonisches Profil: https://ki-agentenkompass.de/agenten/crush/ Redaktion: [Michael Meierhoff](https://ki-agentenkompass.de/ueber-mich/) Quellenabgleich: 2026-11-05 Basis: Anbieter-Dokumentation. Praxisbeispiele sind redaktionelle Vorschläge, keine eigenen Produkttests. ## Einordnung Crush wird von Charmbracelet, Inc. entwickelt. Charm betreibt mit Hyper auch einen eigenen Modellanbieter für Crush, den die Dokumentation als offiziellen Anbieter nennt. - Anbieter: Charm - Produktfamilie: Crush - Profiltyp: Coding-Agent fürs Terminal - Umgebung: Terminal unter macOS, Linux, Windows (PowerShell und WSL), Android, FreeBSD, OpenBSD und NetBSD - Verbindungen: Modellanbieter, LSP-Server, MCP-Server (stdio, http, sse), Agent Skills und Hooks - Einrichtung: Über Homebrew, npm, Paketmanager oder go install installieren, dann ein Modell wählen: Hyper-Konto oder eigener API-Schlüssel. - Kostenmodell: Die Software steht unter der Lizenz FSL-1.1-MIT, nicht unter einer gewöhnlichen Open-Source-Lizenz. Der Modellzugang kostet extra: über Hyper, einen eigenen Schlüssel oder ein lokales Modell. ## Kernfunktionen ### Mehrere Modelle und Anbieter Du wählst Modelle verschiedener Anbieter oder ergänzt eigene über OpenAI- oder Anthropic-kompatible Schnittstellen. Mitten in der Sitzung lässt sich das Modell wechseln, der Kontext bleibt laut README erhalten. Quelle: https://github.com/charmbracelet/crush ### Sitzungen pro Projekt Crush hält mehrere Arbeitssitzungen und Kontexte je Projekt vor. Quelle: https://github.com/charmbracelet/crush ### LSP-Kontext Crush nutzt Language Server als zusätzlichen Kontext; du richtest sie per Befehl ein. Quelle: https://github.com/charmbracelet/crush ### MCP-Erweiterungen MCP-Server über stdio, http und sse erweitern die Werkzeuge. Für http und sse gibt es eingebaute OAuth-Unterstützung. Quelle: https://github.com/charmbracelet/crush ### Rückfrage vor Werkzeugaufrufen Standardmäßig fragt Crush vor Werkzeugaufrufen nach. Du kannst Werkzeuge freigeben, verbieten oder mit --yolo alle Rückfragen überspringen. Quelle: https://github.com/charmbracelet/crush ### Hooks und Agent Skills Hooks sind Shell-Befehle an Punkten des Agentenlaufs; sie können Werkzeugaufrufe blockieren, freigeben oder verändern. Skills folgen dem offenen Agent-Skills-Standard. Quelle: https://github.com/charmbracelet/crush/tree/main/docs/hooks ## Redaktionelle Praxisbeispiele ### Codeänderung mit Rückfrage - Du gibst vor: Ein Projektordner mit AGENTS.md und eine begrenzte Änderung. - Mögliches Ergebnis: Der Agent schlägt Dateiänderungen und Befehle vor und führt sie nach deiner Freigabe aus. - Das prüfst du: Diff und Tests prüfen; Freigaben nur gezielt dauerhaft erteilen. ### Regeln über Hooks absichern - Du gibst vor: Ein Hook je Ereignis, etwa vor Werkzeugaufrufen, mit eigenem Skript. - Mögliches Ergebnis: Das Skript kann Aufrufe blockieren, freigeben oder Eingaben verändern. - Das prüfst du: Hook-Skripte testen; bei Konflikten setzt sich laut Doku ein Verbot gegen eine Freigabe durch. ## Voraussetzungen und Grenzen ### Modellzugang nötig Voraussetzung: Du brauchst ein Hyper-Konto, einen API-Schlüssel eines Anbieters oder ein lokales Modell. Quelle: https://github.com/charmbracelet/crush ### Lizenz mit Wettbewerbsverbot Einschränkung: FSL-1.1-MIT erlaubt jeden Zweck außer einer konkurrierenden Nutzung, ausdrücklich auch interne Nutzung, nicht kommerzielle Bildung und Forschung sowie Dienstleistungen für Lizenznehmer. Konkurrierend ist ein kommerzielles Produkt oder ein Dienst, der Crush oder ein anderes damit angebotenes Charm-Angebot ersetzt oder im Wesentlichen dasselbe leistet. Zwei Jahre nach Veröffentlichung einer Version gilt dafür die MIT-Lizenz. Quelle: https://github.com/charmbracelet/crush/blob/main/LICENSE.md ### Konfiguration ist ausführbarer Code Einschränkung: crushrc und crush.json gelten als vertrauenswürdiger Code und können Befehle ausführen. Die README rät davon ab, Crush in Ordnern mit ungeprüfter Konfiguration zu starten. Quelle: https://github.com/charmbracelet/crush ### --yolo überspringt alle Rückfragen Einschränkung: Das Flag schaltet die Freigabe-Rückfragen ab; die README warnt ausdrücklich davor. Quelle: https://github.com/charmbracelet/crush ### Zeitpläne und Teamverwaltung Noch offen: Die geprüften Seiten beschreiben weder Zeitpläne noch zentrale Verwaltung für Organisationen. Quelle: https://github.com/charmbracelet/crush ## Passt, wenn … - du im Terminal arbeitest und Modelle verschiedener Anbieter oder lokale Modelle nutzen möchtest - du Werkzeugaufrufe vor der Ausführung freigeben willst und Hooks für eigene Regeln brauchst - du LSP-Kontext und MCP-Server in einem Terminal-Agenten verbinden möchtest ## Passt eher nicht, wenn … - du eine gewöhnliche Open-Source-Lizenz brauchst oder ein konkurrierendes kommerzielles Produkt darauf baust - du Zeitpläne oder ereignisgesteuerte Läufe ohne Aufsicht erwartest - du zentrale Team- und Admin-Verwaltung benötigst Redaktionelle Einschätzung auf Basis der Anbieterangaben. Kein Produkttest. ## Nutzbare KI-Modelle Frei wählbar Crush arbeitet mit deinen eigenen Schlüsseln für viele Anbieter wie Anthropic, OpenAI, Gemini, Z.ai oder Moonshot, mit OpenRouter und Charms Dienst Hyper. Weitere Anbieter trägst du über OpenAI- oder Anthropic-kompatible Schnittstellen selbst ein. Lokale Modelle erkennt Crush bei Ollama, LM Studio, llama.cpp und oMLX. - Genannte Modellfamilien: Anthropic (Claude), OpenAI (GPT), Google (Gemini), Z.ai (GLM), MiniMax, Moonshot (Kimi), xAI (Grok), DeepSeek · Weitere Modelle frei anbindbar - Modellwahl: Du wählst - Eigener API-Schlüssel: Ja - Router oder eigener Endpunkt: Ja - Lokale Modelle: Ja Belegt · Quellen abgerufen am: 2026-11-05 - [Crush: Repository](https://github.com/charmbracelet/crush) - [Crush: README](https://raw.githubusercontent.com/charmbracelet/crush/main/README.md) ## Europa & regionale Verfügbarkeit README und Lizenz geprüft. Eine Länderfreigabe oder Datenregion nennen sie nicht; nur Hyper wird als DSGVO-konform bezeichnet. Geprüfter Umfang: Lokale Software; Modellanbieter separat Sichtung am: 2026-11-05 ### Europa: keine Angaben zur Verfügbarkeit Verfügbarkeit noch ungeklärt Crush läuft lokal auf deinem Rechner. Die README nennt Hyper DSGVO-konform und bietet dort laut eigener Angabe Zero Data Retention; Länder oder Datenregionen nennt sie nicht. Anonyme Nutzungsmetriken sind aktiv und lassen sich per CRUSH_DISABLE_METRICS=1 oder DO_NOT_TRACK=1 abschalten. Modellanbieter prüfst du separat. Betroffene Region: EU/EWR, Vereinigtes Königreich und Schweiz Belegter Grund: Die geprüften Quellen nennen dafür keine Länderfreigabe. Offizielle Quelle: https://github.com/charmbracelet/crush ## Konten & Berechtigungen Angaben aus Anbieter-Dokumentation. Rechte hängen von Konto, Integration und Organisationsrichtlinien ab. Prüfe vor dem Einsatz die tatsächlich angeforderten Berechtigungen. Betrachtete Konfiguration: Lokaler Coding-Agent mit eigenem Modellzugang Quellenstand: 2026-11-05 ### Verwendetes Konto Dokumentiert: Du authentifizierst dich im Modellwähler für Hyper oder trägst einen API-Schlüssel ein; alternativ setzt du Umgebungsvariablen wie ANTHROPIC_API_KEY. Für Hyper entsteht ein Konto mit Gratisplan. Nachweis: https://github.com/charmbracelet/crush Nachweis: https://next-docs.charm.land/hyper/plans-billing.html ### Admin-Freigabe In geprüften Quellen offen: Die geprüften Seiten nennen keine Freigabe oder Beschränkung durch Administratoren einer Organisation. Nachweis: https://github.com/charmbracelet/crush ### Datenzugriff & Teamfreigaben Dokumentiert: Standardmäßig fragt Crush vor Werkzeugaufrufen nach. Du kannst Werkzeuge freigeben oder verbieten; --yolo überspringt alle Rückfragen. Einige rein lesende bash-Befehle laufen ohne Rückfrage. Hooks können Aufrufe blockieren oder freigeben. Nachweis: https://github.com/charmbracelet/crush Nachweis: https://github.com/charmbracelet/crush/tree/main/docs/hooks ## Preise und enthaltene Nutzung Preisstand: 2026-11-05 Die Software hat laut geprüften Seiten keinen Preis. Das Modell bezahlst du je nach Weg: eigener Schlüssel oder Hyper mit Gratisplan, Bezahlplänen und Prepaid-Paketen. ### Crush Keine Softwaregebühr genannt Coding-Agent unter FSL-1.1-MIT, mit eigenem Modellzugang. Preisquelle: https://github.com/charmbracelet/crush/blob/main/LICENSE.md ### Hyper Free Kostenlos 100 Hypercredits pro Monat für jedes Konto. Preisquelle: https://next-docs.charm.land/hyper/api/credits.html ### Hyper Paid / Prepaid Preise nicht genannt Laut Doku höhere Monatskontingente und Vorrang bei Modellen; Prepaid-Pakete laufen nicht ab. Preisquelle: https://next-docs.charm.land/hyper/plans-billing.html Die Seiten hyper.charm.land waren für den Abruf nicht lesbar; Hyper-Preise und Datenschutzdetails blieben ungeprüft. Preise und Tarifdetails: https://next-docs.charm.land/hyper/api/credits.html ## Betrieb & Betreuungsbedarf Basis: öffentliche Anbieter-Dokumentation. Einschätzungen sind redaktionelle Ableitungen aus den genannten Eigenschaften. Tatsächlicher Zeitaufwand und Zuverlässigkeit wurden nicht gemessen. Betrachtete Betriebsform: Lokaler Betrieb im Terminal Quellenstand: 2026-11-05 ### Dateien und Arbeitsstand Bedingt dokumentiert: Crush hält Sitzungen je Projekt vor. Zustand liegt unter ~/.local/share/crush; wo der Verlauf genau liegt, steht in der README nicht. Nachweis: https://github.com/charmbracelet/crush ### Anmeldungen Dokumentiert: Anmeldung für Hyper im Modellwähler, sonst API-Schlüssel oder Umgebungsvariablen. Für Bedrock gilt auch eine AWS-Anmeldung. Die Seiten nennen keine Laufzeiten; AWS-SSO-Sitzungen laufen aber regelmäßig ab und lassen sich mit aws_auth_refresh erneuern. Nachweis: https://github.com/charmbracelet/crush ### Start weiterer Läufe In geprüften Quellen offen: Du startest Crush im Terminal und verfolgst den Lauf. Die README erwähnt einen gemeinsamen Hintergrunddienst (crush serve) für mehrere Oberflächen, aber keine Zeitpläne oder Auslöser. Nachweis: https://github.com/charmbracelet/crush ### Menschliche Eingriffe Dokumentiert: Vor Werkzeugaufrufen wird standardmäßig nachgefragt. Freigaben lassen sich je Werkzeug erteilen; --yolo schaltet alle Rückfragen ab. Nachweis: https://github.com/charmbracelet/crush Nachweis: https://github.com/charmbracelet/crush/tree/main/docs/hooks ### Fehler erkennen Bedingt dokumentiert: Logs liegen in ./.crush/logs/crush.log, mit crush logs lesbar und mit --debug ausführlicher. Die Hooks-Doku kennt ein Ereignis StopFailure. Bis auf die Erneuerung von Bedrock-Zugangsdaten über aws_auth_refresh beschreiben die Seiten keine automatischen Wiederholungen. Nachweis: https://github.com/charmbracelet/crush Nachweis: https://github.com/charmbracelet/crush/tree/main/docs/hooks ### Nach Fehlern fortsetzen Bedingt dokumentiert: Auf einem geteilten Backend startet jeder neue Aufruf standardmäßig eine frische Sitzung, und der Sitzungswähler verbindet dich mit einer Sitzung, die ein anderer Client geöffnet hat. Wiederherstellung nach Abstürzen beschreibt die README nicht. Nachweis: https://github.com/charmbracelet/crush ### Redaktionelle Einschätzung Du steuerst Rechte pro Werkzeug und behältst standardmäßig die Rückfrage. Konfigurationsdateien sind ausführbarer Code, und zu Zeitplänen oder Abstürzen schweigen die geprüften Seiten. ## Gedächtnis und Gesprächskontinuität Geltungsbereich: Sitzungen und Kontextdateien des Coding-Agenten pro Projekt Quellen abgerufen: 2026-11-05 Sitzungen sind pro Projekt organisiert; Kontextdateien wie AGENTS.md steuerst du selbst. Wo Verläufe liegen und wie man sie löscht, nennen die geprüften Seiten nicht. ### Speicherort und Umfang Teilweise belegt: Die README nennt mehrere Sitzungen je Projekt und erwähnt eine lokale Datenbank. Anwendungszustand liegt unter ~/.local/share/crush, dort nur JSON. Wo der Gesprächsverlauf liegt, steht nicht dort. - [Crush README](https://github.com/charmbracelet/crush) ### Auswahl und Speicherzeitpunkt Teilweise belegt: Die Initialisierung erzeugt eine Kontextdatei, standardmäßig AGENTS.md, mit Build-Befehlen und Konventionen. Globale Regeln stehen in CRUSH.md oder AGENTS.md. Die Konfigurationsdoku nennt eine Option, lange Gespräche automatisch zusammenzufassen. - [Crush README](https://github.com/charmbracelet/crush) - [Crush: configuration docs](https://github.com/charmbracelet/crush/tree/main/docs/config) ### Einsicht, Bearbeiten und Löschen Teilweise belegt: Kontextdateien bearbeitest du selbst, .crushignore schließt Dateien aus, Logs liegen in ./.crush/logs/crush.log. Das Löschen von Sitzungen beschreiben die geprüften Seiten nicht. - [Crush README](https://github.com/charmbracelet/crush) ### Agenten- und Kanalgrenzen Belegt: Sitzungen gehören zum Projekt. Mehrere Clients mit demselben Arbeitsverzeichnis teilen sich Sitzungsliste, Verlauf, Rechte-Warteschlange, LSP und MCP-Zustand. Globale Kontextdateien gelten projektübergreifend. - [Crush README](https://github.com/charmbracelet/crush) ### Wiederabruf Teilweise belegt: Über den Sitzungswähler greifst du auf vorhandene Sitzungen zu; Kontext bleibt beim Modellwechsel erhalten. Eine Suche über frühere Sitzungen zum automatischen Abruf beschreiben die Seiten nicht. - [Crush README](https://github.com/charmbracelet/crush) ### Session-Reset und Compaction Teilweise belegt: Jeder neue Aufruf beginnt standardmäßig in einer frischen Sitzung. Die Hooks-Doku kennt Ereignisse vor und nach Verdichtung; PreCompact kann sie blockieren. - [Crush README](https://github.com/charmbracelet/crush) - [Crush: hooks](https://github.com/charmbracelet/crush/tree/main/docs/hooks) ## Rahmen Ein Projektordner, Modellzugang und eine begrenzte Codeaufgabe. Standardmäßig fragt Crush vor Werkzeugaufrufen nach; mit --yolo entfällt das. Die Lizenz untersagt konkurrierende kommerzielle Nutzung. Repository, README, Lizenztext, Hooks- und Konfigurationsdoku sowie zwei Hyper-Dokuseiten geprüft. Funktionsbeschreibungen stammen vom Anbieter; Beispielaufträge sind redaktionell. Preise von Hyper-Tarifen und die Seiten hyper.charm.land waren nicht lesbar. Eigene Praxistests stehen aus. ## Offene Punkte Europa, Verfügbarkeit noch ungeklärt: - Europa: keine Angaben zur Verfügbarkeit Voraussetzungen und Grenzen, noch offen: - Zeitpläne und Teamverwaltung ## Quellen - https://github.com/charmbracelet/crush - https://github.com/charmbracelet/crush/blob/main/LICENSE.md - https://github.com/charmbracelet/crush/tree/main/docs/hooks - https://github.com/charmbracelet/crush/tree/main/docs/config - https://next-docs.charm.land/hyper/api/credits.html - https://next-docs.charm.land/hyper/plans-billing.html ## Anbieter Charmbracelet, Inc. veröffentlicht Crush im eigenen GitHub-Repository; die Lizenz nennt das Unternehmen als Lizenzgeber. - Betreiber: Charmbracelet, Inc. - Organisation: Anbieter - Website: https://github.com/charmbracelet/crush - Stand: 2026-11-05 - Repository: https://github.com/charmbracelet/crush - GitHub-Stars: 28966 (2026-11-05) - Lizenz: FSL-1.1-MIT - Anbieterquelle: https://github.com/charmbracelet/crush - Anbieterquelle: https://github.com/charmbracelet/crush/blob/main/LICENSE.md [Quellen und Methode](https://ki-agentenkompass.de/quellen/)