Pour utiliser Crush, l’agent de code de Charm, installez-le avec brew install charmbracelet/tap/crush (ou via npm, winget et d’autres), lancez crush dans un projet, appuyez sur Ctrl+L pour choisir un modèle, collez une clé API ou connectez-vous, puis décrivez la tâche. Crush demande avant d’exécuter des outils, et depuis la version 0.88 ses réglages se trouvent dans un fichier crushrc plutôt que dans crush.json.
Ce guide couvre Crush en novembre 2026 (version 0.101) : installation, fournisseurs et modèles locaux, interface, approbations, crush run, sessions, configuration, fichiers de contexte, MCP et coût.
Ce qu’est Crush
Crush est un agent de code pour le terminal signé Charm, l’équipe derrière Bubble Tea et d’autres outils de terminal, et cela se voit : c’est l’une des interfaces les plus soignées de la catégorie. Il fonctionne avec presque n’importe quel modèle : Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, des modèles locaux et Hyper, le service maison de Charm. Vous pouvez changer de modèle en pleine session sans perdre le contexte.
Crush n’a pas encore atteint la version 1.0 et publie une version mineure environ chaque semaine, avec des builds nightly entre deux. Sa licence est FSL-1.1-MIT : le code source est public et chaque version passe sous licence MIT plus tard, mais ce n’est pas aujourd’hui une licence open source au sens de l’OSI.
Étape 1 : installer
brew install charmbracelet/tap/crush # macOS and Linux
npm install -g @charmland/crush # any platform with Node
winget install charmbracelet.crush # Windows
go install github.com/charmbracelet/crush@latest
Il existe aussi des paquets pour Arch (yay -S crush), Nix, FreeBSD et Scoop, ainsi que des dépôts apt et yum sur repo.charm.sh. Crush tourne sur macOS, Linux, Windows (PowerShell et WSL) et les BSD.
Étape 2 : choisir un modèle
cd my-project
crush
Appuyez sur Ctrl+L pour ouvrir le sélecteur de modèles, choisissez un fournisseur et collez sa clé. Crush lit aussi les clés dans l’environnement, par exemple ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY ou OPENROUTER_API_KEY. Pour utiliser un abonnement plutôt qu’une clé, lancez crush login avec copilot, openai (un forfait ChatGPT), grok ou hyper.
Pour un modèle local, ajoutez un fournisseur dans votre configuration (étape 6) :
provider add ollama --type ollama --base-url "http://localhost:11434/v1/"
Crush récupère sa liste de modèles depuis Catwalk, un catalogue communautaire qui se met à jour tout seul ; crush models montre ce qui est disponible et crush update-providers le rafraîchit.
Étape 3 : travailler dans une session
Décrivez la tâche avec vos mots. Les touches à apprendre en premier :
Ctrl+P(ou/) ouvre la palette de commandes : résumer la session, initialiser le projet, activer ou désactiver serveurs MCP et skills, changer de thème.Ctrl+Lchange de modèle ;Ctrl+Ndémarre une nouvelle session etCtrl+Sliste les sessions.@mentionne un fichier ;Ctrl+Fajoute un fichier ou une image ;Ctrl+Vcolle une image.Shift+Tabfait défiler les modes, dont le mode Plan, où Crush établit les étapes avant de modifier quoi que ce soit.Ctrl+Oouvre votre éditeur pour un long message ;Ctrl+Gaffiche l’aide ;Ctrl+Cquitte.
Étape 4 : approbations et mode yolo
Crush demande avant chaque appel d’outil. Dans la boîte de dialogue, a l’autorise une fois, s autorise cet outil pour le reste de la session, d le refuse et t affiche le diff. Les commandes en lecture seule comme ls ou git status s’exécutent sans demander.
Pour ne plus être sollicité au sujet des outils de confiance, autorisez-les dans votre configuration ; pour masquer complètement un outil, refusez-le :
permissions allow view ls grep edit
permissions deny bash
crush --yolo (ou -y, ou Ctrl+Y dans une session) saute les demandes mais bloque toujours les commandes que Crush juge dangereuses. -yy active le mode sysadmin, qui les autorise aussi. Réservez les deux aux conteneurs et aux machines jetables.
Étape 5 : crush run pour les tâches ponctuelles
crush run "add a unit test for the price formatter"
git diff | crush run "review this diff for bugs"
cat README.md | crush run "tighten the wording" > README.new.md
-m choisit le modèle (provider/model), -q masque l’indicateur de progression, et -s <id> ou -C poursuit une session. crush run n’a pas d’option de sortie JSON : pour des résultats structurés, demandez le format dans le prompt et vérifiez-le.
Étape 6 : crushrc et configuration
Depuis la version 0.88, Crush lit ses réglages dans un fichier crushrc : un script Bash contenant des commandes Crush, exécuté par l’interpréteur propre à Crush pour se comporter de la même façon sous Windows. Il cherche .crushrc ou crushrc dans le projet et ~/.config/crush/crushrc au niveau global, puis fusionne ce qu’il trouve, le projet ayant le dernier mot. Un petit exemple :
model large anthropic/claude-sonnet-5-5
model small anthropic/claude-haiku-5-5
permissions allow view ls grep
mcp add docs --type http --url https://example.com/mcp
lsp add go --command gopls
crush.json et .crush.json fonctionnent encore, mais ils sont dépréciés et ne reçoivent plus de nouvelles fonctionnalités. crush dirs indique où Crush range sa configuration et ses données.
Un avertissement : un crushrc, c’est du code. Tout ce qui se trouve dans $(...) s’exécute au démarrage de Crush ; lisez donc le fichier avant de lancer Crush dans un dépôt que vous ne connaissez pas.
Étape 7 : AGENTS.md, MCP et LSP
Fichiers de contexte. Crush lit AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules et .github/copilot-instructions.md sans aucune configuration, ainsi que ~/.config/crush/CRUSH.md pour tous les projets. Initialize Project, dans la palette de commandes, examine le dépôt et rédige un AGENTS.md. Notre guide sur CLAUDE.md et AGENTS.md explique quoi y mettre.
MCP. Crush prend en charge les serveurs stdio, HTTP et SSE, y compris la connexion OAuth. Ajoutez-les avec mcp add dans crushrc et activez-les ou désactivez-les depuis la palette.
LSP. Les serveurs de langage donnent à Crush les mêmes diagnostics que ceux de votre éditeur. Ajoutez-en un avec lsp add, ou laissez option auto-lsp s’en charger.
Combien coûte Crush (en novembre 2026)
| Option | Prix | Remarques |
|---|---|---|
| Crush | Gratuit | Avec vos propres clés ou des modèles locaux |
| Hyper à l’usage | Dès 5 $ prépayés | Modèles à poids ouverts hébergés par Charm |
| Forfaits mensuels Hyper | De 10 $ à 200 $ par mois | Crédits hebdomadaires avec une fenêtre glissante de 5 heures |
| Votre propre clé | Le prix de votre fournisseur | Anthropic, OpenAI, Gemini, OpenRouter et d’autres |
Crush envoie par défaut des métriques d’usage pseudonymes ; définissez CRUSH_DISABLE_METRICS=1 ou DO_NOT_TRACK=1 pour les désactiver.
Pièges courants
- Suivre des guides crush.json. La plupart des tutoriels antérieurs à août 2026 ne montrent que du JSON. Cela marche encore, mais les nouvelles options arrivent dans
crushrc. - Yolo a changé en v0.100.
--yolobloque désormais les commandes dangereuses au lieu de demander ; les scripts qui comptaient sur l’ancien comportement peuvent avoir besoin de-yy. - Trailers de commit. Crush ajoute par défaut un trailer
Assisted-byaux commits. Modifiez-le avecoption attribution-trailer-style. - Presse-papiers sous Linux. Le copier-coller nécessite
wl-copyouxclip/xsel. - Où sont les logs.
crush logs --tail 50montre ce qui a échoué ; les logs se trouvent dans le dossier.crushdu projet.
Faire tourner Crush à côté d’autres CLI dans AgentVera
Si Crush est votre seul agent, son interface peut vous suffire. Les choses se compliquent quand Crush tourne à côté de Claude Code, Codex ou Gemini CLI sur le même projet. AgentVera est une application de bureau qui exécute ces CLI côte à côte dans de vrais terminaux, avec vos propres installations et clés. La prise en charge de Crush fonctionne ainsi :
- Une session par agent. AgentVera retrouve la session créée par Crush via
crush session list --jsonet la rouvre avec--session <id>aux lancements suivants, si bien que la conversation survit à un redémarrage de l’application. - Un compte par agent. Chaque compte Crush dans Réglages → Comptes a son propre dossier de données et son propre
crush login, et vous pouvez ajouter des clés Anthropic, OpenAI, OpenRouter ou Gemini. - MCP et conflits. Les serveurs du gestionnaire MCP d’AgentVera atteignent Crush via sa configuration, et AgentVera ajoute son propre hook pour voir quels fichiers chaque agent touche.
- Volets et revue. Faites tourner Crush dans la grille du workspace à côté d’autres agents et vérifiez leurs modifications avec la revue de code.
L’offre gratuite exécute 2 agents à la fois et comprend MCP, Git, Docker, SSH, la revue de code et les économies de tokens. Pro coûte 9,99 $ par mois, sans limite d’agents ; si vous n’avez jamais eu d’essai, votre première connexion à l’application active Pro pendant 7 jours, sans carte. Pour essayer, téléchargez AgentVera.
En résumé
Démarrer avec Crush se fait en deux étapes : l’installer et lancer crush, puis choisir un modèle avec Ctrl+L. Ensuite, les réglages qui comptent sont dans crushrc : quels outils peuvent s’exécuter sans demander, quels modèles utiliser pour les grosses et les petites tâches, et quels serveurs MCP et de langage charger. Gardez un AGENTS.md dans le projet, et Crush, comme la plupart des autres agents, le suivra.
Sources : Crush sur GitHub, documentation de configuration, versions, licence, Hyper.