Para usar Crush, el agente de código de Charm, lo instalas con brew install charmbracelet/tap/crush (o con npm, winget y otros), ejecutas crush dentro de un proyecto, pulsas Ctrl+L para elegir un modelo y pegas una clave de API o inicias sesión, y luego describes la tarea. Crush pregunta antes de ejecutar herramientas y, desde la versión 0.88, su configuración vive en un archivo crushrc en lugar de crush.json.
Esta guía cubre Crush a noviembre de 2026 (versión 0.101): instalación, proveedores y modelos locales, la interfaz, aprobaciones, crush run, sesiones, configuración, archivos de contexto, MCP y costes.
Qué es Crush
Crush es un agente de código para la terminal creado por Charm, el equipo detrás de Bubble Tea y otras herramientas de terminal, y se nota: tiene una de las interfaces más pulidas de su categoría. Funciona con casi cualquier modelo: Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, modelos locales y el propio servicio Hyper de Charm. Puedes cambiar de modelo en mitad de una sesión sin perder el contexto.
Crush todavía no ha llegado a la versión 1.0 y publica una versión menor más o menos cada semana, con builds nightly entre medias. Su licencia es FSL-1.1-MIT: el código fuente es público y cada versión pasa a licencia MIT más adelante, pero hoy no es una licencia de código abierto aprobada por la OSI.
Paso 1: instalar
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
También hay paquetes para Arch (yay -S crush), Nix, FreeBSD y Scoop, además de repositorios apt y yum en repo.charm.sh. Crush funciona en macOS, Linux, Windows (PowerShell y WSL) y los BSD.
Paso 2: elegir un modelo
cd my-project
crush
Pulsa Ctrl+L para abrir el selector de modelos, elige un proveedor y pega su clave. Crush también lee claves del entorno, por ejemplo ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY u OPENROUTER_API_KEY. Si prefieres usar una suscripción en vez de una clave, ejecuta crush login con copilot, openai (un plan de ChatGPT), grok o hyper.
Para un modelo local, añade un proveedor en tu configuración (paso 6):
provider add ollama --type ollama --base-url "http://localhost:11434/v1/"
Crush obtiene su lista de modelos de Catwalk, un catálogo comunitario que se actualiza solo; crush models muestra lo que hay disponible y crush update-providers lo refresca.
Paso 3: trabajar en una sesión
Describe la tarea con tus palabras. Las teclas que conviene aprender primero:
Ctrl+P(o/) abre la paleta de comandos: resumir la sesión, inicializar el proyecto, activar o desactivar servidores MCP y skills, cambiar el tema.Ctrl+Lcambia de modelo;Ctrl+Nempieza una sesión nueva yCtrl+Slista las sesiones.@menciona un archivo;Ctrl+Fañade un archivo o una imagen;Ctrl+Vpega una imagen.Shift+Tabrecorre los modos, incluido el modo Plan, en el que Crush define los pasos antes de editar.Ctrl+Oabre tu editor para escribir un mensaje largo;Ctrl+Gmuestra la ayuda;Ctrl+Csale.
Paso 4: aprobaciones y modo yolo
Crush pregunta antes de cada llamada a una herramienta. En el diálogo, a la permite una vez, s permite esa herramienta durante el resto de la sesión, d la rechaza y t muestra el diff. Los comandos de solo lectura como ls o git status se ejecutan sin preguntar.
Para que deje de preguntarte por herramientas de confianza, permítelas en la configuración; para ocultar una herramienta por completo, deniégala:
permissions allow view ls grep edit
permissions deny bash
crush --yolo (o -y, o Ctrl+Y dentro de una sesión) se salta las confirmaciones, pero sigue bloqueando los comandos que Crush considera peligrosos. -yy activa el modo sysadmin, que también los permite. Reserva ambos para contenedores y máquinas desechables.
Paso 5: crush run para tareas puntuales
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 elige el modelo (provider/model), -q oculta el indicador de progreso y -s <id> o -C continúa una sesión. crush run no tiene salida JSON, así que, si necesitas resultados estructurados, pide el formato en el prompt y compruébalo.
Paso 6: crushrc y configuración
Desde la versión 0.88, Crush lee su configuración de un archivo crushrc: un script Bash con comandos de Crush que ejecuta el propio intérprete de Crush, para que se comporte igual en Windows. Busca .crushrc o crushrc en el proyecto y ~/.config/crush/crushrc a nivel global, y combina lo que encuentra; si hay conflicto, gana el proyecto. Un ejemplo pequeño:
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 y .crush.json siguen funcionando, pero están obsoletos y no reciben funciones nuevas. crush dirs muestra dónde guarda Crush su configuración y sus datos.
Una advertencia: un crushrc es código. Todo lo que esté dentro de $(...) se ejecuta al arrancar Crush, así que lee el archivo antes de abrir Crush en un repositorio que no conoces.
Paso 7: AGENTS.md, MCP y LSP
Archivos de contexto. Crush lee AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules y .github/copilot-instructions.md sin configurar nada, además de ~/.config/crush/CRUSH.md para todos los proyectos. Initialize Project en la paleta de comandos examina el repositorio y escribe un AGENTS.md. Nuestra guía de CLAUDE.md y AGENTS.md explica qué poner en él.
MCP. Crush admite servidores stdio, HTTP y SSE, incluido el inicio de sesión con OAuth. Añádelos con mcp add en crushrc y actívalos o desactívalos desde la paleta.
LSP. Los servidores de lenguaje le dan a Crush los mismos diagnósticos que ve tu editor. Añade uno con lsp add o deja que option auto-lsp los configure.
Lo que cuesta Crush (a noviembre de 2026)
| Opción | Precio | Notas |
|---|---|---|
| Crush | Gratis | Con tus propias claves o modelos locales |
| Hyper de pago por uso | Desde 5 $ prepago | Modelos de pesos abiertos alojados por Charm |
| Planes mensuales de Hyper | De 10 $ a 200 $ al mes | Créditos semanales con una ventana móvil de 5 horas |
| Tu propia clave | El precio de tu proveedor | Anthropic, OpenAI, Gemini, OpenRouter y más |
Crush envía métricas de uso seudónimas por defecto; define CRUSH_DISABLE_METRICS=1 o DO_NOT_TRACK=1 para desactivarlas.
Errores habituales
- Seguir guías de crush.json. La mayoría de los tutoriales anteriores a agosto de 2026 solo muestran JSON. Sigue funcionando, pero las opciones nuevas llegan a
crushrc. - Yolo cambió en la v0.100.
--yoloahora bloquea los comandos peligrosos en lugar de preguntar; los scripts que dependían del comportamiento anterior pueden necesitar-yy. - Trailers en los commits. Crush añade por defecto un trailer
Assisted-bya los commits. Cámbialo conoption attribution-trailer-style. - Portapapeles en Linux. Copiar y pegar requiere
wl-copyoxclip/xsel. - Dónde están los logs.
crush logs --tail 50muestra qué ha fallado; los logs están en la carpeta.crushdel proyecto.
Ejecutar Crush junto a otras CLI en AgentVera
Si Crush es el único agente que usas, puede que su propia interfaz te baste. La cosa se complica cuando Crush corre junto a Claude Code, Codex o Gemini CLI en el mismo proyecto. AgentVera es una app de escritorio que ejecuta estas CLI una al lado de otra en terminales reales, con tus propias instalaciones y claves. El soporte de Crush funciona así:
- Una sesión por agente. AgentVera encuentra la sesión que crea Crush mediante
crush session list --jsony la reabre con--session <id>en los siguientes arranques, así que la conversación sobrevive a un reinicio de la app. - Una cuenta por agente. Cada cuenta de Crush en Ajustes → Cuentas tiene su propia carpeta de datos y su propio
crush login, y puedes añadir claves de Anthropic, OpenAI, OpenRouter o Gemini. - MCP y conflictos. Los servidores del gestor de MCP de AgentVera llegan a Crush a través de su configuración, y AgentVera añade su propio hook para ver qué archivos toca cada agente.
- Paneles y revisión. Ejecuta Crush en la cuadrícula del workspace junto a otros agentes y revisa sus cambios con la revisión de código.
El plan gratuito ejecuta 2 agentes a la vez e incluye MCP, Git, Docker, SSH, revisión de código y ahorro de tokens. Pro cuesta 9,99 $ al mes y no tiene límite de agentes; si nunca has tenido una prueba, tu primer inicio de sesión en la app activa Pro durante 7 días sin tarjeta. Para probarlo, descarga AgentVera.
Conclusión
Empezar con Crush lleva dos pasos: instalarlo y ejecutar crush, y luego elegir un modelo con Ctrl+L. A partir de ahí, la configuración que importa está en crushrc: qué herramientas pueden ejecutarse sin preguntar, qué modelos usar para tareas grandes y pequeñas, y qué servidores MCP y de lenguaje cargar. Ten un AGENTS.md en el proyecto y Crush, como la mayoría de los agentes, lo seguirá.
Fuentes: Crush en GitHub, documentación de configuración, versiones, licencia, Hyper.