No entries match these filters. Clear filters
Crush v0.96 adds theme support via command palette with live preview and custom palettes
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.96.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.96.0
└──▷ HOW TO FIND IT
Open the command palette in Crush and select the Themes option to browse built-in themes like Gruvbox Dark or launch the editor for custom palettes.
📍 Run the crush command, press your keybinding for the command palette (e.g., Ctrl+P), and type Themes to open the dialog.
Adds theme support accessible from the command palette, including built-in Gruvbox Dark and the ability to create or edit custom palettes directly in the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. . Not checked yet Enables real-time display of hypercredits during execution. Not checked yet
2 details in Everything
Crush v0.94.1 adds --reasoning-effort flag and ChatGPT OAuth
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.94.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.94.1
└──▷ USE IT
Run a non-interactive task with maximum reasoning effort for complex queries
shell
copy
crush run --model "hyper/glm-5.3" --reasoning-effort "max"
Adds --reasoning-effort flag to crush run for controlling reasoning depth in non-interactive mode Not checked yet Integrates ChatGPT subscription authentication via new OAuth flow replacing OpenAI client-server Swagger deps Not checked yet
2 details in Everything
Crush v0.93.1 adds options.tui.mouse config to disable mouse support and routes GPT-6 Astra/Grok via /responses endpoint.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.93.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.93.1
└──▷ USE IT
Same capability expressed in JSON configuration format.
json
copy
{ "options": { "tui": { "mouse": false } } }
Crush v0.91.2 adds automatic sessionless mode for MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. and new Qwen3.8 Hyper models.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.91.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.91.2
Enables Qwen3.8-Flash, Qwen3.8-27B, and Qwen3.8-2.4T-A95B models via Hyper Not checked yet
1 detail in Everything
Crush v0.91.0 adds text selection and mouse support to the session picker.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.91.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.91.0
Adds <kbd>shift</kbd>+arrow keys and mouse drag text selection in the prompt editor with cut/copy/paste shortcuts Not checked yet Adds mouse wheel scrolling, single-click select, and double-click open to the session picker Not checked yet
2 details in Everything
Crush v0.89.0 adds bash syntax highlighting, ctrl+end jump-to-bottom, and session ID on exit.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.89.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.89.0
Adds ctrl+end keybinding to jump to the bottom of the chat and enable follow mode so new messages auto-scroll. Not checked yet Displays a session ID splash screen on exit, so you can quickly resume the last session on next launch. Not checked yet Adds syntax highlighting to bash commands shown when Crush executes via the Bash tool, improving legibility. Not checked yet Strips redundant cd-to-project prefix from Bash tool command display to reduce visual noise. Not checked yet
4 details in Everything
Crush v0.88.0 adds .crushrc bash-based config, permissions deny, AWS Bedrock SSO SSO Single sign-on, using one identity provider to sign in to multiple applications. It reduces separate passwords and centralizes account and access management. re-auth, and new crushrc builtins for providers, models, MCPs, LSPs, and hooks.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.88.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.88.0
└──▷ TRY IT
Bootstrap a dotfiles-friendly crushrc that adds a local Ollama provider, auto-approves safe tools, and loads machine-specific overrides that stay out of git.
copy
$ cat ~/.config/crush/crush.sh
# Add Ollama.
provider add ollama --type ollama --base-url "http://localhost:11434/v1"
# Register a model on Ollama.
model add ollama/llama3.3 --name "Llama 3.3" --context-window 128000
# Auto-approve read/write tools.
permissions allow view edit
# Load machine-specific secrets (kept in .gitignore).
source "$XDG_CONFIG_HOME/local-overrides.sh"
Apply different skill paths per hostname using crushrc conditionals and option reset.
copy
$ cat >> ~/.config/crush/crush.sh <<'EOF'
if [[ $HOSTNAME == "workstation" ]]; then
option skill-path "$HOME/work-skills"
else
option reset skill-path
fi
EOF
Adds .crushrc bash-based configuration file, replacing JSON config with a scriptable shell format that supports conditionals, source includes, and environment variable expansion. Not checked yet Adds permissions deny command in crushrc to explicitly hide specific tools from the agent. Not checked yet Adds permissions allow command in crushrc to auto-approve tools without prompting. Not checked yet Adds provider add and model add crushrc builtins for registering custom providers and models (e.g. local Ollama instances). Not checked yet Adds mcp add / mcp remove crushrc builtins for managing MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. servers directly from the shell config. Not checked yet
+7 more
show less
Adds lsp add / lsp remove crushrc builtins for managing LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. servers from crushrc. Not checked yet Adds hook add / hook remove crushrc builtins for managing agent hooks from crushrc. Not checked yet Adds option reset command to wipe list-type shell config options back to defaults. Not checked yet Exposes CRUSH_VERSION environment variable inside crushrc scripts for version-conditional configuration. Not checked yet Adds automatic re-authentication UX for AWS Bedrock SSO token expiry, with automatic turn retry after re-auth. Not checked yet Supports building and running Crush on illumos (OpenIndiana, OmniOS). Not checked yet Applies top-level environment variables from crushrc on startup. Not checked yet
12 details in Everything
Crush v0.87.0 adds MCP OAuth MCP OAuth An authentication layer for the Model Context Protocol that lets MCP clients obtain delegated access tokens so cyber tools can call MCP servers on a user's behalf without handling raw credentials. 2.1, Claude Channels MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. extension, and a system-wide config at /etc/crush/crush.json
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.87.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.87.0
Adds OAuth 2.1 OAuth 2.1 A consolidated draft of the OAuth authorization framework that merges OAuth 2.0 with its most important security BCP updates, dropping unsafe flows so tools can delegate user access without handling credentials directly. authorization support for HTTP and SSE SSE Server-Sent Events, a browser API and HTTP-based protocol where a server pushes a stream of text events to a client over a single long-lived connection, giving tools a lightweight alternative to WebSockets for one-way real-time updates. MCP servers, unblocking MCPs that require authentication. Not checked yet Supports the Claude Channels MCP extension, allowing MCP servers to push real-time notifications into Crush. Not checked yet Supports system-wide configuration via /etc/crush/crush.json, improving NixOS and multi-user deployments. Not checked yet Significant LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. performance improvement: filters servers before searching $PATH, reducing CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. and memory usage in large repositories. Not checked yet Improves bang-mode output streaming performance by avoiding quadratic shell output rendering. Not checked yet
5 details in Everything
Crush v0.86.0 adds LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. rename/replace tools, scrollable sidebar, removable attachments, and SSH-friendly OAuth URL copy.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.86.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.86.0
└──▷ TRY IT
Get aggregate token/cost stats across all sessions or a specific directory tree without opening the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. .
Scope stats to a particular project directory when working in a monorepo.
copy
$ crush stats --crawl-dir ./services/auth
Adds lsp_rename tool: renames a symbol and all its references across the project via LSP. Not checked yet Adds lsp_replace_symbol tool: replaces, inserts before/after, or deletes an entire function, method, or class by name via LSP. Not checked yet Enables scrollable sidebar with keyboard (l/h/j/k/g/G/arrows) and mouse-wheel navigation when sidebar content overflows. Not checked yet Adds clickable ✕ button on attachment chips to remove attachments with the mouse. Not checked yet Adds <kbd>u</kbd> keybinding in the OAuth dialog to copy the verification URL — enables authentication over SSH where auto-browser-open is unavailable. Not checked yet
+2 more
show less
Adds quit-dialog hint showing that pressing Ctrl+C twice skips the confirmation prompt. Not checked yet Adds --all and --crawl-dir modes to the stats subcommand. Not checked yet
7 details in Everything
Crush v0.85.0 adds an interactive question tool, an elapsed-time timer, and LM Studio vision support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.85.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.85.0
Adds a first-class question tool letting LLMs LLMs A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. prompt users with single-choice, multiple-choice, free-form text, and yes/no forms — with full mouse support. Not checked yet Displays an elapsed-seconds timer so you can see how long the LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. has been running. Not checked yet Enables LM Studio vision capabilities (image support) via SupportsImages. Not checked yet Adds automatic transparent auth retry so dropped credentials are refreshed without user intervention. Not checked yet
4 details in Everything
Crush v0.84.0 adds session-affinity headers for provider-side prompt caching.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.84.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.84.0
Sends x-session-affinity and x-session-id headers with every request, enabling supporting providers to pin sessions to a replica and maximize prompt cache hits. Not checked yet
1 detail in Everything
Crush v0.83.0 adds GPT-5.6 support, routing it through the Responses API.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.83.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.83.0
Crush v0.82.0 adds preserved newlines in expanded tool output and Alibaba US region support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.82.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.82.0
└──▷ TRY IT
Use Alibaba's US-region endpoint instead of Singapore for lower-latency access from North America.
copy
$ export ALIBABA_US_API_KEY=<your-key>
crush
Preserves newlines in expanded tool content in the chat UI, improving readability of multi-line tool outputs. Not checked yet Adds Alibaba (United States) as a supported provider region, configurable via ALIBABA_US_API_KEY. Not checked yet
2 details in Everything
Crush v0.81.0 adds a configurable chat scrollbar, herdr.dev agent-status integration, and expandable tool-call names.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.81.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.81.0
└──▷ USE IT
Keep the scrollbar permanently visible in long sessions so you always know your position in the conversation.
json
copy
{
"options": {
"tui": {
"scrollbar": "always"
}
}
}
Adds a scrollbar to the chat view, configurable via options.tui.scrollbar (default, always, or never). Not checked yet Adds herdr.dev socket integration so herdr can receive agent status signals (blocked/finished) and send notifications. Not checked yet Enables expanding tool-call names in the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. for easier inspection of long-running or complex tool invocations. Not checked yet
3 details in Everything
Crush v0.80.0 adds auto-detection of local model context windows context windows The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. and a llamacpp provider enricher.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.80.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.80.0
Automatically detects context window context window The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. sizes for local model endpoints (llamacpp, omlx, lmstudio, litellm, ollama) — no more zero-size window misconfigurations. Not checked yet Adds a llamacpp provider enricher, enabling richer model discovery metadata when connecting to llama.cpp servers. Not checked yet Logs provider warnings surfaced from agent step results, making model-side issues visible in the session output. Not checked yet
3 details in Everything
Bang Mode gains live output streaming, cancellation, copy-to-clipboard, and string-prefix invocation in v0.79.0.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.79.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.79.0
Streams Bang Mode command output in real time as long-running commands execute, with a pending spinner while waiting. Not checked yet Enables cancelling a running Bang Mode command mid-execution. Not checked yet Adds copy-to-clipboard for Bang Mode command results (with ANSI codes stripped). Not checked yet Supports prefixing an arbitrary string with Bang Mode to inline shell output directly into a prompt. Not checked yet
4 details in Everything
Crush v0.78.0 adds bang mode for inline shell execution, local model auto-discovery, Fireworks provider support, and improved clipboard handling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.78.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.78.0
└──▷ TRY IT
Run a shell command mid-session and immediately ask the LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. to reason about its output — without leaving Crush.
copy
$ !ls -la /etc/cron.d
Point Crush at a local Ollama instance and let it discover available models automatically — no manual model list needed.
json
copy
{
"providers": {
"ollama": {
"name": "Ollama",
"base_url": "http://localhost:11434/v1/",
"type": "ollama"
}
}
}
Adds bang mode: type ! in a session to run Bash commands directly, with output fed back into the LLM context for follow-up questions. Not checked yet Enables auto-discovery of local models (Ollama, LM Studio, LiteLLM, MLX MLX Apple's machine-learning framework for Apple silicon, which uses the unified memory shared by CPU and GPU to run and fine-tune models on a Mac. ) from OpenAI-compatible endpoints — no manual model definitions required. Not checked yet Adds Fireworks (fireworks.ai) as a supported LLM provider. Not checked yet Improves clipboard support on X11 and Wayland: removes xclip/xsel dependencies, adds TIFF paste support, and enables Super+V / ⌘+V image pasting. Not checked yet
4 details in Everything
Crush v0.77.0 adds global user-level context files and named hooks for easier hook management.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.77.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.77.0
└──▷ TRY IT
Set a global persona or default preferences (e.g., preferred VCS VCS Version control system: software that tracks changes to files over time, letting teams collaborate and roll back mistakes. Cyber tools use it to manage source code, configs, and signatures. ) that Crush picks up in every project without touching per-repo config.
copy
$ mkdir -p ~/.config/crush
cat >> ~/.config/crush/CRUSH.md <<'EOF'
Always refer to me as Shirley. Default to Jujutsu (jj) for version-control commands unless the project already uses plain git.
EOF
Name hooks so you can tell them apart when multiple hooks fire on the same event.
json
copy
{
"hooks": {
"PreToolUse": [
{
"name": "lint-before-bash",
"matcher": "bash",
"command": "./hooks/run-lint.sh"
}
]
}
}
Adds user-level context files: place ~/.config/AGENTS.md or ~/.config/crush/CRUSH.md to give Crush persistent, cross-project instructions at session start. Not checked yet Adds a name field to hook definitions, making individual hooks identifiable in the CLI output. Not checked yet
2 details in Everything
Crush v0.76.0 adds monorepo skill discovery and shows all providers in crush models
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.76.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.76.0
└──▷ TRY IT
Browse every available model across all supported providers before committing to one — useful when evaluating which provider to configure.
Discovers skills from the git repository root in monorepos, so .agents/skills/, .crush/skills/, .claude/skills/, and .cursor/skills/ at the repo root are found even when running from a subdirectory. Not checked yet Expands crush models to list all known providers and their models, not just configured ones — unconfigured providers are marked with (not configured). Not checked yet
2 details in Everything
Crush v0.74.0 adds SSH notifications, diff view for denied tools, and deeper client-server session sharing
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.74.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.74.0
└──▷ TRY IT
Run the experimental client-server mode to share a workspace across multiple terminal sessions.
copy
$ CRUSH_CLIENT_SERVER=1 crush
Adds diff view for denied tools so practitioners can inspect exactly what a tool was attempting before deciding to allow or block it. Not checked yet Supports notifications over SSH terminals, enabling alerts when running Crush on remote hosts. Not checked yet Adds configurable notification backend with bell support and a backend picker UI. Not checked yet Exposes an in-progress flag and connected-client count on session API responses, enabling richer monitoring of active sessions. Not checked yet Server now shares one workspace per directory across all connected clients, reducing duplication in multi-client setups. Not checked yet
+4 more
show less
Server broadcasts config changes to all connected clients in real time. Not checked yet Tracks which session each client is currently viewing, enabling per-client session awareness. Not checked yet Auto-closes permission prompts when another client in the same session has already responded. Not checked yet Refuses to open a data directory already in use by another Crush instance, preventing data corruption. Not checked yet
9 details in Everything
Crush v0.73.0 adds a dedicated AWS Bedrock Europe (eu-west-1) provider for EU-based users.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.73.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.73.0
Adds a Bedrock Europe provider that routes all requests to eu-west-1, alongside the existing Bedrock US (us-east-1) provider. Not checked yet
1 detail in Everything
Crush v0.72.0 adds ctrl+y YOLO toggle, skill descriptions, session scrollbar, and auto-expanded TODO list.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.72.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.72.0
Adds ctrl+y keybinding to instantly toggle YOLO mode (with on-screen notification) without opening the command palette. Not checked yet Displays descriptions alongside user-invocable skill commands in the skill picker for easier discovery. Not checked yet Adds a scrollbar to the sessions list dialog for easier navigation of long session lists. Not checked yet Auto-expands the TODO list by default when terminal height is sufficient; toggle with ctrl+t. Not checked yet
4 details in Everything
Crush v0.71.0 adds user-invocable skills, pipe/redirect permission prompts, and a model-list scrollbar.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.71.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.71.0
Adds support for user-invocable skills, letting users directly invoke defined skills from the chat interface. Not checked yet Requires a permission prompt whenever the model attempts to run Bash commands containing pipes, redirection, or other chained operators. Not checked yet Adds a scrollbar to the model selection list (dialog and onboarding) for easier navigation of long model lists. Not checked yet Defaults AWS Bedrock integration to the us-east-1 region, making all Bedrock models available out-of-the-box without local region configuration. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! AWS Bedrock now always uses us-east-1 as the region, ignoring any value set in AWS_REGION or AWS_DEFAULT_REGION.
Crush v0.70.0 adds Alibaba (Singapore) as a new AI provider and extends retries to cover network-level failures.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.70.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.70.0
└──▷ TRY IT
Enable experimental client-server mode to support multiple sessions or remote Crush connections.
copy
$ export CRUSH_CLIENT_SERVER=1
crush
Adds Alibaba (Singapore) as a new model provider, including access to Qwen models, configurable via the model picker or $ALIBABA_SINGAPORE_API_KEY. Not checked yet Extends retry logic to cover network errors (e.g., transient offline states, DNS failures) in addition to HTTP error codes. Not checked yet
2 details in Everything
Crush v0.69.0 adds a -p flag and new styling to the dirs command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.69.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.69.0
└──▷ TRY IT
Use the new -p flag with the dirs command to control directory path output.
Adds -p flag to the dirs command for additional directory output control. Not checked yet Adds styling improvements to the dirs command output. Not checked yet
2 details in Everything
Crush v0.68.0 adds an OAuth logout command, MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. tool allow-listing, and auto-hints for gh/ripgrep in the system prompt.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.68.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.68.0
Adds logout command for OAuth sessions. Not checked yet Adds an allow list for MCP tools, letting you restrict which tools the model can invoke. Not checked yet Automatically mentions gh and rg (ripgrep) in the system prompt when they are available, hinting the model to use them. Not checked yet Extends the prompt templating system to cover more prompt types. Not checked yet Removes the legacy long system prompt option (CRUSH_SHORT_TOOL_DESCRIPTIONS=0 no longer accepted). Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! The CRUSH_SHORT_TOOL_DESCRIPTIONS=0 opt-in for the old long system prompt is removed; there is no longer a way to restore the previous prompt.
Crush v0.67.0 adds a built-in shell interpreter for hooks, shell expansion in config values, and a touch tool for empty file creation.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.67.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.67.0
└──▷ USE IT
Pull an API key from Vault at runtime so secrets never live in your Crush config file.
json
copy
"api_key": "$(vault kv get my/secret/token)"
Hooks now run via the built-in shell interpreter (mvdan/sh) by default, improving portability and Windows support; shebangs are still respected. Not checked yet Shell expansion now works in config values (e.g., "api_key": "$(vault kv get my/secret/token)") via the embedded interpreter, including MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. args, URLs, and LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. args/env. Not checked yet New write tool (via touch) lets the model create empty files, gated by a permission prompt for paths outside the working directory. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The Assisted-by Git commit trailer format has changed: it was Assisted-by: {modelName} via Crush <crush@charm.land> and is now Assisted-by: Crush:{modelID}.
Crush v0.66.1 adds flat_rate provider config to skip per-token cost tracking for subscription-based providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.66.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.66.1
└──▷ USE IT
Suppress cost tracking for a subscription provider so Crush doesn't report misleading $0.00 per-token charges.
json
copy
{
"providers": {
"my-favorite-provider": {
"flat_rate": true
}
}
}
Crush v0.65.2 adds first-class support for Hyper, Charm's privacy-focused inference service, with credit balance shown in the sidebar.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.65.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.65.2
Adds Hyper integration: Charm's new coding-focused inference service Private beta is now a first-class provider in Crush. Not checked yet Displays remaining Hypercredits balance in the sidebar so you can track usage at a glance. Not checked yet
2 details in Everything
Crush v0.63.0 introduces PreToolUse hooks to intercept, deny, or rewrite tool calls before execution.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.63.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.63.0
Adds PreToolUse hook that runs before any tool call, enabling deny, halt, rewrite of bash commands, or silent side effects. Not checked yet Introduces built-in crush-hook skill to build, manage, and configure hooks from within Crush. Not checked yet Supports Claude Code hooks for compatibility with existing hook scripts. Not checked yet
3 details in Everything
Crush v0.62.0 cuts ~120k tokens/session with shorter tool descriptions and auto-renders diffs from any tool output.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.62.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.62.0
Automatically detects and renders diff-formatted output from any tool (e.g. GitHub MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server) with full diff UI, not just the built-in edit tool. Not checked yet Short tool descriptions are now the default, saving ~120k tokens per session and improving behaviour of small/local models with limited context windows context windows The maximum amount of text, counted in tokens, a model can take in and produce in one request. Everything the model knows about the task has to fit inside it. . Not checked yet
2 details in Everything
└──▷ BREAKING ON UPGRADE
! Short tool descriptions are now the default; sessions relying on the verbose system prompt will behave differently unless CRUSH_SHORT_TOOL_DESCRIPTIONS=0 is explicitly set (this opt-out may be removed in a future release).
Crush v0.61.1 adds iTerm2 progress bar support with a progress toggle in crush.json.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.61.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.61.1
└──▷ USE IT
Disable the agent progress bar in iTerm2 (or any supported terminal) when you find it distracting during long-running tasks.
json
copy
{
"options": {
"progress": false
}
}
Adds options.progress key to crush.json (set to false to disable) to control the agent progress bar display. Not checked yet Extends progress bar support to iTerm2, joining Ghostty and Rio as supported terminals. Not checked yet
2 details in Everything
Crush v0.60.0 adds OpenAI-compatible endpoint support for the Hyper provider.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.60.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.60.0
Supports OpenAI-compatible endpoint for the Hyper provider, enabling use of Hyper through standard OpenAI-compatible API tooling. Not checked yet
1 detail in Everything
Crush v0.59.0 adds built-in jq support with a dedicated skill, skills discovery in the sidebar, and Rio Terminal progress bar feedback.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.59.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.59.0
Adds built-in jq as a bash builtin so agents can query JSON files without requiring jq installed on the host machine. Not checked yet Includes a built-in jq skill to instruct the model on how to invoke jq during agentic tasks. Not checked yet Shows available skills in the sidebar and landing page for improved discoverability. Not checked yet Enables progress bar feedback when running inside Rio Terminal. Not checked yet
4 details in Everything
Crush v0.58.0 adds support for OpenCode Zen and OpenCode Go model providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.58.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.58.0
Crush v0.57.0 adds opt-in ~98% token savings via CRUSH_SHORT_TOOL_DESCRIPTIONS and HYPER_API_KEY auth support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.57.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.57.0
└──▷ TRY IT
Opt in to drastically shorter tool descriptions to slash token usage — especially useful on long sessions or when costs matter.
copy
$ export CRUSH_SHORT_TOOL_DESCRIPTIONS=1
crush
Adds CRUSH_SHORT_TOOL_DESCRIPTIONS env flag to reduce tool call description sizes by ~98%, saving an estimated 120K tokens per session. Not checked yet Adds support for HYPER_API_KEY environment variable for Hyper authentication. Not checked yet The crush_info tool now displays your attribution settings alongside other configuration details. Not checked yet
3 details in Everything
Crush v0.56.0 adds crush_info and crush_logs self-diagnostic tools so the AI can inspect its own config and logs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.56.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.56.0
└──▷ USE IT
Prevent the model from ever reading your configuration or logs — useful in shared or locked-down environments.
json
copy
{
"options": {
"disabled_tools": ["crush_info", "crush_logs"]
}
}
Adds crush_info tool: exposes the final merged configuration to the model so it can self-diagnose provider, LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. , and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. setup. Not checked yet Adds crush_logs tool: surfaces Crush's own application logs to the model for in-session debugging. Not checked yet Supports disabling either self-diagnostic tool via the disabled_tools config option to prevent the model from ever calling them. Not checked yet Automatically opens the Hyper auth dialog on unauthorized errors, reducing manual intervention when credentials expire. Not checked yet
4 details in Everything
Crush v0.55.0 adds a built-in self-configuration skill, skill disabling, and an experimental server-client architecture.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.55.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.55.0
└──▷ USE IT
Disable the built-in crush-config skill (or any other skill) for a project that should not allow self-modification.
json
copy
{
"$schema": "https://charm.land/crush.json",
"options": {
"disabled_skills": ["crush-config"]
}
}
Opt into the experimental server-client architecture to try the new RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. backend.
copy
$ CRUSH_CLIENT_SERVER=1 crush
Adds built-in Crush config skill so Crush can configure itself — add providers, MCPs, LSPs, or change settings via natural language without manual JSON editing. Not checked yet Supports disabling any skill (built-in, global, or project) via the new disabled_skills array in crush.json. Not checked yet Introduces experimental RPC server-client architecture, enabled with the CRUSH_CLIENT_SERVER=1 environment variable. Not checked yet Serves generated Swagger API docs from the server when running in server-client mode. Not checked yet
4 details in Everything
Crush v0.54.0 adds skill metadata to session commands and respects custom Git global ignore files.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.54.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.54.0
└──▷ TRY IT
Review which skills an AI session exercised — useful for auditing agent behavior after a run.
copy
$ crush session show
Check the most recent session's skill usage without knowing its ID.
copy
$ crush session last
Adds skill metadata header to crush session show and crush session last output, listing all skills used by a session. Not checked yet Supports Git's core.excludesfile custom global ignore file when listing project files. Not checked yet
2 details in Everything
Crush v0.53.0 adds Z.ai GLM-5.1 model support and a dynamic prompt input area that grows up to 15 rows.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.53.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.53.0
Crush v0.52.0 adds project-level skills, agent-detection env vars, and smarter file picker ranking.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.52.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.52.0
└──▷ TRY IT
Gate a script's behavior on whether it is being invoked by Crush (or any compatible AI agent) using the new env vars.
copy
$ if [ "$CRUSH" = "1" ] || [ "$AI_AGENT" = "crush" ]; then echo 'Running inside Crush — skipping interactive prompts'; fi
Adds project-scoped skills: Crush now auto-loads skills from .agents/skills, .crush/skills, .claude/skills, or .cursor/skills, making team skill-sharing as simple as committing files. Not checked yet Sets CRUSH=1, AGENT=crush, and AI_AGENT=crush environment variables when running Bash commands, letting tools detect they are running inside Crush. Not checked yet Improves @-triggered file picker with a significantly better completion ranking algorithm, especially useful in large repositories. Not checked yet Expands Windows global skills path to include ~/.config/crush/skills and ~/.config/agents/skills alongside the AppData location. Not checked yet Improves system prompt to enforce model responses and session titles in the same language as the user's prompt. Not checked yet
5 details in Everything
Crush v0.51.0 adds native Docker MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. Catalog integration and new --continue/--session CLI flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.51.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.51.0
└──▷ TRY IT
Resume the last AI session non-interactively to continue a scripted or automated workflow without re-entering context.
copy
$ crush run --continue
Jump back into a specific named session from the terminal, skipping the session-picker UI.
copy
$ crush --session <session-id>
Enable the Docker MCP Catalog so Crush can pull in context-relevant MCPs (e.g. Postgres, ARM ARM A family of RISC processor architectures designed by Arm Holdings and licensed to chip makers worldwide; tools target it to run natively on mobile, embedded, and increasingly server and desktop hardware. ) on demand during a conversation.
📍 In Crush, press ctrl+p, then choose Enable Docker MCP Catalog (requires Docker Desktop to be running).
Integrates the Docker MCP Catalog natively, pulling relevant MCPs on demand during conversations (enable via ctrl+p > Enable Docker MCP Catalog with Docker Desktop running). Not checked yet Adds crush r and crush s as short aliases for crush run and crush session. Not checked yet Adds --continue flag to resume the last session in both TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. (crush --continue) and non-interactive (crush run --continue) modes. Not checked yet Adds --session <session-id> flag to open a specific past session directly from the CLI or TUI. Not checked yet
4 details in Everything
Crush v0.50.1 adds support for OpenAI GPT-5.4 Mini and GPT-5.4 Nano, with Nano as the new default small model.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.50.1
Adds support for OpenAI GPT-5.4 Mini and GPT-5.4 Nano models. Not checked yet Sets GPT-5.4 Nano as the new default small model for OpenAI. Not checked yet
2 details in Everything
crush run gains --continue and --session flags to resume past sessions non-interactively
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.50.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.50.0
└──▷ TRY IT
Pick up where you left off in the most recent session without opening the interactive UI.
copy
$ crush run --continue "tell me more"
Continue a specific past session by ID — useful in scripts where you track session IDs from crush session list --json.
copy
$ crush run --session <session-id> "um, can you repeat that?"
Adds --continue (-C) flag to crush run to resume the most recent session non-interactively. Not checked yet Adds --session (-s) flag to crush run to resume a specific session by ID non-interactively. Not checked yet
2 details in Everything
Crush v0.49.0 adds transparent-mode toggle, AWS Bedrock API key pasting, and configurable Bash tool auto-background timing.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.49.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.49.0
Adds a command-palette (ctrl+p) toggle to enable/disable background color (transparent mode ), persisted across sessions. Not checked yet Supports pasting AWS Bedrock API keys directly in the provider input, alongside the existing environment-variable method. Not checked yet Adds auto_background_after parameter to the Bash tool, letting the model specify how many seconds before a command is moved to a background job (default: 60s). Not checked yet
3 details in Everything
Crush v0.48.0 adds desktop notifications, CLI session management with JSON output, and a user-agent identifier.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.48.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.48.0
Adds desktop notifications on turn completion and permission requests, with an in-app toggle. Not checked yet New crush session list command to browse past sessions from the CLI. Not checked yet New crush session <id> command to inspect a former session in full; supports --json for structured output structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. usable by agents and automation. Not checked yet Supports renaming and deleting sessions from the CLI via crush session. Not checked yet Crush now presents a Charm-Crush/<version> User-Agent header on all network requests, making it identifiable in observability and proxy tools. Not checked yet
5 details in Everything
Crush v0.47.2 adds OpenAI GPT-5.4 and GPT-5.4 Pro model support plus Zhipu and QiniuCloud providers.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.47.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.47.2
Adds support for OpenAI GPT-5.4 and GPT-5.4 Pro models (required an explicit Crush update to enable). Not checked yet Adds Zhipu and Zhipu Coding (bigmodel.cn) as new AI providers. Not checked yet Adds QiniuCloud as a new AI provider. Not checked yet
3 details in Everything
Crush v0.47.0 adds a blocking wait: true parameter to job_output to eliminate polling on background jobs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.47.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.47.0
Crush v0.46.0 adds MiniMax China provider and granular Anthropic reasoning levels for Opus/Sonnet 4.6.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.46.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.46.0
Adds MiniMax China as a new provider, using the China-specific endpoint for Chinese users. Not checked yet Adds granular reasoning/thinking effort levels for Anthropic Opus 4.6 and Sonnet 4.6, replacing the previous on/off toggle with adaptive level selection. Not checked yet
2 details in Everything
Crush v0.45.0 adds GPT-5.3 Codex support and granular Gemini 3 thinking-level controls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.45.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.45.0
Adds GPT-5.3 Codex as a selectable model via the model picker. Not checked yet Adds granular thinking-level selection for Gemini 3 and 3.1 (replaces the previous on/off toggle). Not checked yet
2 details in Everything
Crush v0.44.0 adds visual confirmation when skills are loaded so you know the LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. isn't improvising.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.44.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.44.0
Adds UI indicator showing when a skill is actively loaded, distinguishing real skill execution from LLM improvisation. Not checked yet
1 detail in Everything
Crush v0.43.0 adds a toggle todos/pills menu item and glob-based gitignore for faster monorepo handling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.43.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.43.0
Adds a toggle todos/pills menu item to the UI. Not checked yet Replaces regex-based gitignore parsing with glob-based matching, reducing CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. and disk usage on large repositories. Not checked yet
2 details in Everything
Crush v0.42.0 adds GLM 5 via z.AI and surfaces user-configured LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. servers in the UI before they start.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.42.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.42.0
Adds GLM 5 model support via z.AI as a new provider option. Not checked yet Shows user-configured LSP servers in the UI with an unstarted status before they are invoked. Not checked yet
2 details in Everything
Crush v0.41.0 adds in-TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. editing of API keys and OAuth re-authentication via ctrl+e.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.41.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.41.0
└──▷ HOW TO FIND IT
Rotate or correct an API key for a configured model without leaving the TUI.
📍 # Inside crush TUI:
# Press ctrl+m to open the models dialog
# Select the model whose key you want to update
# Press ctrl+e to edit the API key
Adds ability to edit API keys directly in the TUI: open the models dialog (ctrl+m), select a model, and press ctrl+e — no more manual edits to crush.json. Not checked yet Supports OAuth2 OAuth2 An open authorization framework (RFC 6749) that lets a service grant limited access to a user's resources on another service without exposing credentials, giving cyber tools a standard way to authenticate against third-party APIs. re-authentication via the same ctrl+e shortcut for OAuth providers, triggering the full OAuth2 flow in-app. Not checked yet
2 details in Everything
Crush v0.40.0 adds on-demand LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. startup, MiniMax provider support, MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. resources, and clipboard image paste.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.40.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.40.0
Adds on-demand LSP server startup — servers launch only when the model interacts with a file of that language, and are shut down between sessions. Not checked yet Supports MiniMax as a new AI provider, including the MiniMax Coding Plan. Not checked yet Adds MCP resources support. Not checked yet Enables clipboard image paste via Ctrl+V. Not checked yet
4 details in Everything
Crush v0.39.0 adds prompt history navigation, session rename/delete, collapsible chat blocks, and a transparent UI mode.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.39.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.39.0
Adds Up/Down arrow key history navigation to cycle through past prompts, similar to Bash and VSCode. Not checked yet Enables renaming sessions with Ctrl+R and deleting sessions with Ctrl+X from the session dialog. Not checked yet Supports click-to-expand/collapse for code blocks, diffs, and thinking blocks in the chat. Not checked yet Shows last-updated time for each session in the sessions dialog. Not checked yet Displays the active provider name in the sidebar, panel, and message footers. Not checked yet
+2 more
show less
Adds transparent mode for the UI. Not checked yet Adds a configurable timeout for LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. initialization. Not checked yet
7 details in Everything
Crush v0.38.0 adds Vercel as a native provider with broader model support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.38.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.38.0
Adds Vercel as a dedicated provider (previously treated as an OpenAI provider), enabling access to Vercel's full model catalog. Not checked yet
1 detail in Everything
Crush v0.37.0 adds LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. auto-discovery, MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server-side instructions, prompt history, and more Copilot models including Gemini 3 Pro/Flash.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.37.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.37.0
└──▷ TRY IT
Try the new experimental UI without changing any config permanently.
copy
$ CRUSH_NEW_UI=1 crush
Adds automatic LSP discovery — Crush detects and configures installed language servers without manual setup. Not checked yet Supports MCP server-side instructions for richer model-context-protocol integrations. Not checked yet Adds prompt history so previous inputs can be recalled during a session. Not checked yet Expands available Copilot models, including Gemini 3 Pro Preview and Gemini 3 Flash Preview . Not checked yet Opens the commands dialog by pressing / for faster command access. Not checked yet
+3 more
show less
Adds per-session file tracking to scope file awareness to the current session. Not checked yet Enables disabling the indeterminate progress bar via configuration. Not checked yet Previews a new UI, accessible by setting CRUSH_NEW_UI=1 in the environment. Not checked yet
8 details in Everything
Crush v0.36.0 adds crush stats usage dashboard, session deletion, session title editing, and multi-file drag & drop.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.36.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.36.0
└──▷ TRY IT
View a breakdown of your Crush token usage and session history for the current project at a glance.
New crush stats command displays a per-project usage dashboard with token and session statistics. Not checked yet Adds ability to delete sessions directly from the UI. Not checked yet Enables renaming/updating session titles. Not checked yet Supports drag & drop of multiple files at once, including on Windows. Not checked yet
4 details in Everything
Crush v0.35.0 adds Vercel AI Gateway support, an LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. restart command, and a keybinding to copy chat messages.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.35.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.35.0
└──▷ TRY IT
Try the in-progress UI refactor to get faster rendering and provide early feedback.
copy
$ CRUSH_NEW_UI=1 crush
Supports Vercel AI Gateway as a new AI provider integration. Not checked yet Adds lsp_restart command to restart the language server from within Crush. Not checked yet Adds a keybinding to copy chat message content to clipboard. Not checked yet Previews a new UI refactor accessible via CRUSH_NEW_UI=1, including an onboarding flow. Not checked yet
4 details in Everything
Crush v0.34.0 adds --model flag for non-interactive runs, a crush models listing command, file attachments, paste-as-file, and a new opt-in UI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.34.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.34.0
└──▷ TRY IT
Run a headless prompt against a specific provider and model in CI — no interactive session needed.
copy
$ echo 'Summarize the diff below' | crush run --model 'openai/gpt-5.2-codex'
Discover which models are configured, then narrow to a provider before scripting against it.
copy
$ crush models | grep openai
Preview and test the new UI overhaul without affecting your default workflow.
copy
$ CRUSH_NEW_UI=1 crush
Adds --model flag to crush run for specifying a provider/model in non-interactive/CI mode using {model} or {provider}/{model} format. Not checked yet New crush models command lists all configured models and providers, composable with grep. Not checked yet Supports sending prompts with file attachments even when the text body is empty. Not checked yet Adds attachment support: files can be attached to prompts in interactive mode. Not checked yet Adds paste-as-file capability, turning large pastes into attachments automatically. Not checked yet
+5 more
show less
New completions menu for the editor input. Not checked yet Expandable thinking display for assistant responses in chat. Not checked yet File picker dialog with image preview and Kitty graphics protocol Kitty graphics protocol A terminal graphics protocol created by the Kitty terminal emulator project that lets applications render pixel-accurate images directly inside a terminal, giving cyber tools rich visual output without a GUI. support (including inside tmux). Not checked yet Terminal tab title is now set automatically to reflect the working directory. Not checked yet New opt-in overhauled UI available via CRUSH_NEW_UI=1 environment variable. Not checked yet
10 details in Everything
Crush v0.33.2 adds clipboard image paste directly into the chat editor.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.33.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.33.2
Crush v0.32.0 adds a config option to disable default providers and allows sending prompts with attachments but no text.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.32.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.32.0
└──▷ TRY IT
Suppress all default cloud providers so only locally configured models are available — useful in air-gapped or local-only setups.
copy
$ CRUSH_DISABLE_DEFAULT_PROVIDERS=1 crush
Adds disable_default_providers config setting to suppress all built-in cloud providers, useful when running exclusively with local models. Not checked yet Enables sending a prompt that contains only file/text attachments with no typed text. Not checked yet
2 details in Everything
Crush v0.31.0 adds cross-tool skills loading from ~/.config/agents/skills and removes Claude Code support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.31.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.31.0
Supports loading skills from a shared ~/.config/agents/skills directory, enabling reuse across multiple agent tools. Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Claude Code support has been removed; any workflow relying on Claude Code integration will no longer function after upgrading.
Crush v0.30.3 adds five new models for GitHub Copilot users: Claude Opus 4.5, GPT 5.2, GPT 5.1, GPT 5.1 Codex, and GPT 5.1 Max.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.30.3 https://github.com/charmbracelet/crush.git
$ git checkout v0.30.3
Adds Claude Opus 4.5 as a selectable model for GitHub Copilot users. Not checked yet Adds GPT 5.2, GPT 5.1, GPT 5.1 Codex, and GPT 5.1 Max as selectable models for GitHub Copilot users. Not checked yet
2 details in Everything
Crush v0.30.0 adds Agent Skills support, letting you extend the AI agent with on-demand capabilities via the open agentskills.io format.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.30.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.30.0
Supports the Agent Skills open format, enabling on-demand agent capability extensions that load automatically without cluttering context. Not checked yet
1 detail in Everything
Crush v0.29.0 adds drag-and-drop and paste-as-attachment support for images and large text blobs.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.29.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.29.0
Supports dragging and dropping attachments of all kinds directly into the terminal UI. Not checked yet Automatically treats large pasted text as an attachment instead of inline input. Not checked yet
2 details in Everything
Crush v0.28.0 adds env-var overrides for config directories and Hyper/Copilot login via onboarding.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.28.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.28.0
Adds ability to set environment variables to override config directories. Not checked yet Enables Hyper and GitHub Copilot login directly through the onboarding flow. Not checked yet
2 details in Everything
Crush v0.27.0 adds GitHub Copilot as a supported AI backend with a new crush login copilot auth command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.27.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.27.0
└──▷ TRY IT
Authenticate with GitHub Copilot when it isn't already detected on the machine.
copy
$ crush login copilot
Adds GitHub Copilot as a supported model provider, auto-detecting existing logins or prompting via TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. . Not checked yet New crush login copilot command for explicit GitHub Copilot authentication. Not checked yet
2 details in Everything
Crush v0.26.0 adds Hyper terminal integration.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.26.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.26.0
Crush v0.25.0 adds crush projects command for centralized project tracking with JSON output support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.25.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.25.0
└──▷ TRY IT
Enumerate all known Crush projects in machine-readable JSON to feed into scripts or CI pipelines.
copy
$ crush projects --json
Adds crush projects command to list all projects where Crush has been used, with --json flag for programmatic consumption. Not checked yet
1 detail in Everything
Crush v0.24.0 adds a first-class to-do list tool and pipe/redirect support for crush run.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.24.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.24.0
└──▷ TRY IT
Pipe a file into Crush and redirect its output — useful for automated summarization or review tasks in CI.
copy
$ crush run "Summarize this project" > summary.md
Chain both stdin and stdout redirection to process a file and capture the result in one shot.
copy
$ crush run "Rate my Pokémon collection" < Pokedex.md > Pokerating.md
Adds a built-in to-do list tool so Crush can create and manage task lists during complex multi-step operations. Not checked yet Enables input/output redirection and piping in crush run non-interactive mode, allowing integration with shell pipelines. Not checked yet
2 details in Everything
Crush v0.23.0 adds GPT-5.2 and GPT-5.1 Codex Max support, plus MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. disabled_tools config.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.23.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.23.0
└──▷ USE IT
Suppress noisy or dangerous MCP tools from being offered to the model without removing the whole server.
yaml
copy
# In your MCP server config block, add:
disabled_tools:
- bash
- write_file
Adds support for OpenAI GPT-5.2 as a selectable model. Not checked yet Adds support for GPT-5.1 Codex Max model. Not checked yet New disabled_tools list in MCP config lets you suppress specific MCP tools without removing the server. Not checked yet Shows a / hint in the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. editor when the input field is empty, surfacing command discovery. Not checked yet
4 details in Everything
Crush v0.22.2 sorts sessions by recent activity and improves Claude token refresh for long sessions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.22.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.22.2
Sorts sessions by most recently used activity instead of creation time in the Ctrl+S session dialog. Not checked yet
1 detail in Everything
Crush v0.22.0 adds DuckDuckGo web search and image-returning tool/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. support via agentic fetch.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.22.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.22.0
Adds DuckDuckGo-powered web search: tell Crush what you're looking for and it uses agentic fetch to search and retrieve results while keeping search context out of the main session. Not checked yet Supports image results returned by tools and MCPs (e.g., Playwright), enabling visual web agentic workflows. Not checked yet
2 details in Everything
Crush v0.21.0 adds parallel tool call execution and progress bar support for iTerm2 and Rio terminals.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.21.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.21.0
Enables parallel tool calls so multiple tools can execute simultaneously, reducing wait time on multi-step tasks. Not checked yet Adds progress bar display for iTerm2 and Rio terminal emulators. Not checked yet
2 details in Everything
Adds crush login claude CLI command for authenticating with Claude Code Max in SSH/tmux environments.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.20.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.20.1
└──▷ TRY IT
Authenticate with Claude Code Max over SSH or inside tmux where opening a browser or copying a URL to the clipboard isn't possible.
copy
$ crush login claude
Crush v0.19.0 adds Claude Code Max subscription support for Anthropic model access.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.19.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.19.0
Supports Claude Code Max subscriptions — select an Anthropic model and Crush will prompt you through the authentication flow. Not checked yet
1 detail in Everything
Crush v0.18.4 adds support for Kimi's coding subscription plan as a model provider.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.4 https://github.com/charmbracelet/crush.git
$ git checkout v0.18.4
Crush v0.18.3 adds full Google Gemini 3 support and in-app new-version notifications.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.3 https://github.com/charmbracelet/crush.git
$ git checkout v0.18.3
Adds support for Google Gemini 3 across models hosted on Google and OpenRouter OpenRouter A unified API gateway that routes requests to dozens of LLM providers under one endpoint, letting cyber tools swap or compare models without rewriting provider-specific integration code. . Not checked yet Notifies users in-app when a new version of Crush is available. Not checked yet
2 details in Everything
Crush v0.18.2 adds Mode 2026 terminal sync for smoother rendering and defaults attribution to assisted-by.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.18.2
Supports Mode 2026 terminal rendering synchronization via Bubble Tea v2, delivering smoother UI updates in compatible terminals. Not checked yet Defaults commit/output attribution to assisted-by mode. Not checked yet
2 details in Everything
Crush v0.18.1 adds support for GPT-5.1, GPT-5.1-Codex, and GPT-5.1-Codex-Mini models.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.18.1
Crush now defaults to AGENTS.md for new projects, aligning with the emerging agents.md convention.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.18.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.18.0
Crush v0.17.0 adds a recent-models picker and opt-in AI attribution trailers to git commits.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.17.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.17.0
Adds a recent models section at the top of the model picker so frequently used models are surfaced automatically. Not checked yet Adds trailer_style config option to append an Assisted-by git trailer (e.g. Assisted-by: Claude Sonnet 4.5 via Crush) to commits, following Fedora Council AI-disclosure guidelines. Not checked yet Migrates the deprecated co_authored_by config setting to the new attribution scheme. Not checked yet
3 details in Everything
Crush v0.16.0 adds background jobs so the LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. can spawn and manage parallel processes like servers and builds.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.16.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.16.0
└──▷ BREAKING ON UPGRADE
! Persistent shell has been removed.
Crush v0.15.2 adds Ctrl+L/Ctrl+M hotkeys to open the model switcher from anywhere.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.15.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.15.2
Adds Ctrl+L and Ctrl+M keyboard shortcuts to open the model switcher without leaving the keyboard. Not checked yet
1 detail in Everything
Crush v0.15.0 adds an agentic fetch tool for reasoning over URL content plus keyboard shortcut UX improvements.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.15.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.15.0
Adds an agentic fetch tool that lets subagents pull content from a URL, reason over it, and iterate until they find what they need. Not checked yet Press / in an empty textarea to open the command palette (in addition to the existing ctrl+p shortcut). Not checked yet Use @ to open the file picker in the chat input. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! The @ key now opens the file picker instead of /; existing muscle memory using / to pick files will no longer work — press / in an empty input to get the command palette instead.
Crush v0.14.0 adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. Prompt template support and startup progress feedback on Ghostty/Windows Terminal.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.14.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.14.0
Supports MCP stored prompts (templates): access via ctrl+p then the MCP tab in the command prompt. Not checked yet Shows a progress bar loading feedback during startup on Ghostty and Windows Terminal. Not checked yet
2 details in Everything
Crush v0.13.7 adds Azure reasoning-level support and significantly faster rendering for long sessions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.13.7 https://github.com/charmbracelet/crush.git
$ git checkout v0.13.7
Enables full OpenAI feature set for Azure-hosted models, including reasoning effort levels (Low, Medium, High). Not checked yet Significantly faster rendering and lower CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. usage when scrolling through large, long conversations. Not checked yet
2 details in Everything
Crush v0.13.0 adds an openai-compat provider type for better support of OpenAI-compatible APIs with extra features.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.13.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.13.0
└──▷ USE IT
Switch a custom OpenAI-compatible provider to the new type to get improved behavior and access to previously unavailable features.
json
copy
{
"$schema": "https://charm.land/crush.json",
"providers": {
"my-custom-provider": {
"type": "openai-compat"
}
}
}
Crush v0.12.0 adds LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. -powered Find References tool and AWS Bearer Token Bearer Token A credential that grants access to whoever presents it, without a separate proof of possession. Protecting the token matters because a stolen copy can be used by someone else. support for Bedrock
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.12.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.12.0
New Find References tool taps into attached LSPs to locate symbol references with greater speed and precision than the grep tool. Not checked yet Supports AWS_BEARER_TOKEN_BEDROCK environment variable for authenticating with AWS Bedrock. Not checked yet
2 details in Everything
Crush v0.11.0 adds terminal progress bar support, MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. notifications, and automatic filepath walk limits.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.11.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.11.0
Adds application-level progress bar display in supporting terminals (Windows Terminal, Ghostty). Not checked yet Adds MCP notifications support including tools/list_changed events, enabling real-time tool updates to MCP clients like Neovim. Not checked yet Adds automatic filepath walk limits, with lower limits applied automatically when not in a git repository. Not checked yet
3 details in Everything
Crush v0.10.4 adds crush dirs subcommand to resolve config and data directory paths from the CLI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.10.4 https://github.com/charmbracelet/crush.git
$ git checkout v0.10.4
└──▷ TRY IT
Open Crush's main config file directly without manually hunting down the path.
copy
$ vim "$(crush dirs config)/crush.json"
Wipe all ephemeral Crush data (sessions, cache) for a clean slate.
copy
$ rm -rf "$(crush dirs data)"
Crush v0.10.0 adds Hugging Face inference support, recursive config search, custom Gemini providers, and pseudoanonymous usage metrics.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.10.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.10.0
Adds Hugging Face inference provider integration. Not checked yet Supports custom providers of type gemini in config. Not checked yet Searches crush.json recursively up from the working directory. Not checked yet Loads LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. defaults by either name or command. Not checked yet Pretty-prints MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. JSON in permissions output. Not checked yet
+2 more
show less
Adds alt/option+esc key binding as an alias for the existing esc behavior. Not checked yet Adds pseudoanonymous usage metrics (device hash only; prompts and responses never collected) with opt-out support. Not checked yet
7 details in Everything
Crush v0.9.0 overhauls LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. via Power Nap library and adds configurable attribution in commit messages.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.9.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.9.0
Rewrites LSP implementation using the Power Nap library, reducing codebase complexity and improving LSP experience. Not checked yet Adds attribution settings to config and bash tool, allowing users to disable Crush attribution in commit messages. Not checked yet
2 details in Everything
Crush v0.8.0 adds in-app OpenAI reasoning controls, offline mode, tool disabling, and a new crush update-providers command.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.8.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.8.0
└──▷ TRY IT
Lock Crush to fully offline operation in air-gapped or restricted environments — no outbound calls to catwalk.charm.sh.
copy
$ export CRUSH_DISABLE_PROVIDER_AUTO_UPDATE=1
Manually refresh provider/model definitions when internet access is available, or seed from a vetted local file.
copy
$ crush update-providers /path/to/local-providers.json
Restrict the AI agent to read-only tools by disabling shell execution and write capabilities in the config.
json
copy
{
"options": {
"disabled_tools": [
"bash",
"write",
"edit",
"multiedit",
"download"
]
}
}
Adds in-app reasoning level selector for OpenAI models that support reasoning, previously only configurable by manually editing crush.json. Not checked yet New crush update-providers command lets practitioners manually pull provider/model updates from Catwalk, a custom URL, a local file, or the embedded bundle. Not checked yet New disable_provider_auto_update option in crush.json (or CRUSH_DISABLE_PROVIDER_AUTO_UPDATE env var) enables a fully offline mode, preventing outbound fetches to catwalk.charm.sh. Not checked yet New disabled_tools config option lets users selectively block individual agent tools (e.g., bash, fetch, write) from being available to the model. Not checked yet Model chooser now supports multi-word search and matches on provider name, making it easier to locate a specific model by provider. Not checked yet
5 details in Everything
Crush v0.7.9 cuts LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. file descriptors by 99% for dramatically faster multi-LSP workflows.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.7.9 https://github.com/charmbracelet/crush.git
$ git checkout v0.7.9
Optimizes LSP file watcher with 99% reduction in file descriptors, improving performance when using multiple LSPs. Not checked yet
1 detail in Everything
Crush v0.7.8 adds multiline paste support on Windows and enables SQLite secure_delete for safer data handling.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.7.8 https://github.com/charmbracelet/crush.git
$ git checkout v0.7.8
Enables bracketed paste on Windows, allowing multiline text to be pasted correctly. Not checked yet Enables SQLite secure_delete pragma so deleted database records are securely overwritten. Not checked yet
2 details in Everything
Crush v0.7.5 shows the persistent shell path in the permission dialog for better shell-action transparency.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.7.5 https://github.com/charmbracelet/crush.git
$ git checkout v0.7.5
Displays the persistent shell path in the permission dialog so users can see exactly which shell session is being granted access. Not checked yet
1 detail in Everything
Crush v0.7.2 adds Anthropic custom base URL support and shows current path on project initialization.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.7.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.7.2
Supports configuring a custom Anthropic base URL option for routing API traffic through proxies or compatible endpoints. Not checked yet Displays the current directory path when prompting to initialize a new project. Not checked yet
2 details in Everything
Crush v0.7.0 adds a --data-dir flag and git-style parent-directory discovery for the .crush state folder.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.7.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.7.0
└──▷ TRY IT
Point Crush at a shared data directory on a per-invocation basis, useful when you want to keep project state outside the default location.
copy
$ crush --data-dir /path/to/project/.crush
Adds --data-dir (-D) flag to specify a custom path for the .crush data directory at runtime. Not checked yet Automatically discovers a .crush directory in any parent directory, similar to how git locates .git, so subdirectory work reuses the project's data dir. Not checked yet
2 details in Everything
Crush v0.6.3 adds LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. custom env vars, auto-.gitignore for workspace dir, and tighter shell command restrictions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.6.3 https://github.com/charmbracelet/crush.git
$ git checkout v0.6.3
Supports setting custom environment variables for LSP servers via config. Not checked yet Automatically creates a .crush/.gitignore so the workspace directory is excluded from Git without manual intervention. Not checked yet Removes go from the list of safe programs the model is allowed to run, narrowing the permitted command surface. Not checked yet Compiled with Go's GreenTea Garbage Collector, reducing memory footprint and CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. usage. Not checked yet
4 details in Everything
Crush v0.6.2 adds Android/Termux support for on-the-go use.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.6.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.6.2
Crush v0.6.1 adds configurable MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. timeouts, automatic MCP reconnection, and per-filetype LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. scoping.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.6.1 https://github.com/charmbracelet/crush.git
$ git checkout v0.6.1
└──▷ USE IT
Cap a slow remote MCP server at 30 seconds so it doesn't block your workflow indefinitely.
json
copy
{
"mcp": {
"example": {
"type": "http",
"url": "https://example.org/mcp/",
"timeout": 30
}
}
}
Restrict gopls to only activate on Go-related files, keeping the LSP from interfering with other file types.
json
copy
{
"lsp": {
"Go": {
"command": "gopls",
"filetypes": ["go", "mod", "sum", "work"]
}
}
}
Adds configurable per-MCP timeout in config (default 15 seconds) so unreliable MCP servers don't hang Crush indefinitely. Not checked yet Enables automatic MCP client ping and reconnection when an MCP server becomes unresponsive. Not checked yet Supports restricting LSP servers to specific file types via a filetypes config key for improved efficiency. Not checked yet Ships built-in filetype associations for 17 popular language servers (gopls, rust-analyzer, pyright, typescript-language-server, and more), so no manual scoping is needed for common LSPs. Not checked yet
4 details in Everything
Crush v0.6.0 adds Power Steering, letting you queue messages to the model mid-task without interrupting its tool calls.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.6.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.6.0
Crush v0.5.0 adds configurable default diff mode (unified or split) via the TUI TUI A text-based user interface that runs inside a terminal, using characters and ANSI escape codes to render menus, panes, and widgets without a graphical desktop, letting cyber tools ship rich interactivity with no GUI dependency. config.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.5.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.5.0
└──▷ USE IT
Set your preferred diff mode so every session opens in split view without manual toggling.
json
copy
{
"options": {
"tui": {
"diff_mode": "split"
}
}
}
Crush v0.4.0 adds in-session Yolo Mode toggle, diff view mouse scrolling, built-in coreutils on Windows, and CRUSH_-prefixed env vars.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.4.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.4.0
└──▷ TRY IT
Start a session with all permission dialogs bypassed from the command line.
Toggle Yolo Mode on or off mid-session without restarting.
📍 Press ctrl+p, then select Toggle Yolo Mode from the menu.
Adds in-session Yolo Mode toggle via ctrl+p menu, so you can enable/disable permission bypass without restarting Crush. Not checked yet Enables mouse scrolling in the diff view. Not checked yet Ships built-in coreutils (base64, gzip, mktemp, shasum, tar) on Windows — and speeds them up on all platforms by eliminating shell-outs. Not checked yet Supports CRUSH_-prefixed environment variables (e.g. CRUSH_ANTHROPIC_API_KEY) to scope secrets to Crush without clobbering default env vars. Not checked yet
4 details in Everything
Crush v0.3.0 adds mouse text selection, drag-and-drop image input, GPT-5 support, and OpenAI reasoning model improvements.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.3.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.3.0
Adds mouse-based text selection in chat messages, including double-click to select and copy. Not checked yet Supports drag-and-drop image input into the chat from almost any terminal, including Apple Terminal. Not checked yet Adds out-of-the-box support for GPT-5 as an OpenAI provider. Not checked yet Supports minimal reasoning mode for OpenAI reasoning models. Not checked yet Available on Nixpkgs unstable for easier installation. Not checked yet
5 details in Everything
Crush v0.2.2 adds JetBrains rendering support, Scoop distribution for Windows, and LSP LSP Language Server Protocol, the standard way editors get code intelligence such as completions, go-to-definition and errors from a separate per-language server. Coding agents use it to understand code. /MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. status indicators in the UI.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.2.2 https://github.com/charmbracelet/crush.git
$ git checkout v0.2.2
└──▷ TRY IT
Install Crush on Windows using Scoop when you need a package-managed install that stays up to date.
copy
$ scoop bucket add charm https://github.com/charmbracelet/scoop-bucket.git && scoop install crush
Adds vastly improved rendering support for JetBrains terminals (JediTerm) used in GoLand, IntelliJ, PyCharm, and similar IDEs. Not checked yet Adds Scoop package distribution for easy installation on Windows. Not checked yet Adds LSP and MCP status indicators in the UI showing offline, starting up, online, and error states; full details viewable via crush logs. Not checked yet Adds Escape key as an additional way to deny prompts in the UI. Not checked yet
4 details in Everything
Crush v0.2.0 adds .crushignore support and enhanced debug logging with provider response capture.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.2.0 https://github.com/charmbracelet/crush.git
$ git checkout v0.2.0
└──▷ TRY IT
Capture full provider request/response traffic to diagnose unexpected model behaviour or prompt issues.
copy
$ crush --debug && crush logs
Adds .crushignore file support to exclude files from Crush's context without removing them from version control; uses .gitignore syntax and works in the project root and subdirectories. Not checked yet Extends --debug mode to also log provider request/response details, stored in .crush/logs/crush.log and viewable via crush logs. Not checked yet Applies .crushignore and .gitignore rules to the built-in grep tool, scoping searches consistently with context exclusions. Not checked yet
3 details in Everything
Crush v0.1.6 is the first public release of Charmbracelet's AI coding assistant for the terminal.
└──▷ GET THIS VERSION
copy
$ git clone --branch v0.1.6 https://github.com/charmbracelet/crush.git
$ git checkout v0.1.6
Introduces Crush, a new terminal-native AI coding assistant CLI from Charmbracelet. Not checked yet Supports release artifact verification via cosign and sha256sum for supply-chain integrity. Not checked yet
2 details in Everything