Crush

No entries match these filters. Clear filters

1. v0.96.0 Sep 21, 2026 · release notes

   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
   # already have the repo? check out this version:
   $ 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 TUITUIA 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..
   • Enables real-time display of hypercredits during execution.

   2 details in Everything

2. v0.94.1 Sep 12, 2026 · release notes

   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
   # already have the repo? check out this version:
   $ 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
   • Integrates ChatGPT subscription authentication via new OAuth flow replacing OpenAI client-server Swagger deps

   2 details in Everything

3. v0.93.1 Sep 9, 2026 · release notes

   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
   # already have the repo? check out this version:
   $ git checkout v0.93.1

   └──▷ USE IT
   Same capability expressed in JSON configuration format.
   json copy

   { "options": { "tui": { "mouse": false } } }

4. v0.91.2 Aug 26, 2026 · release notes

   Crush v0.91.2 adds automatic sessionless mode for MCPMCPModel 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
   # already have the repo? check out this version:
   $ git checkout v0.91.2

   • Enables Qwen3.8-Flash, Qwen3.8-27B, and Qwen3.8-2.4T-A95B models via Hyper

   1 detail in Everything

5. v0.91.0 Aug 22, 2026 · release notes

   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
   # already have the repo? check out this version:
   $ 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
   • Adds mouse wheel scrolling, single-click select, and double-click open to the session picker

   2 details in Everything

6. v0.89.0 Aug 12, 2026 · release notes

   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
   # already have the repo? check out this version:
   $ 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.
   • Displays a session ID splash screen on exit, so you can quickly resume the last session on next launch.
   • Adds syntax highlighting to bash commands shown when Crush executes via the Bash tool, improving legibility.
   • Strips redundant cd-to-project prefix from Bash tool command display to reduce visual noise.

   4 details in Everything

7. v0.88.0 Jul 31, 2026 · issue 032

   Crush v0.88.0 adds .crushrc bash-based config, permissions deny, AWS Bedrock SSOSSOSingle 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
   # already have the repo? check out this version:
   $ 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.
   • Adds permissions deny command in crushrc to explicitly hide specific tools from the agent.
   • Adds permissions allow command in crushrc to auto-approve tools without prompting.
   • Adds provider add and model add crushrc builtins for registering custom providers and models (e.g. local Ollama instances).
   • Adds mcp add / mcp remove crushrc builtins for managing MCPMCPModel 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.

   +7 more show less

   • Adds lsp add / lsp remove crushrc builtins for managing LSPLSPLanguage 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.
   • Adds hook add / hook remove crushrc builtins for managing agent hooks from crushrc.
   • Adds option reset command to wipe list-type shell config options back to defaults.
   • Exposes CRUSH_VERSION environment variable inside crushrc scripts for version-conditional configuration.
   • Adds automatic re-authentication UX for AWS Bedrock SSO token expiry, with automatic turn retry after re-auth.
   • Supports building and running Crush on illumos (OpenIndiana, OmniOS).
   • Applies top-level environment variables from crushrc on startup.

   12 details in Everything

8. v0.87.0 Jul 24, 2026 · issue 025

   Crush v0.87.0 adds MCP OAuthMCP OAuthAn 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 MCPMCPModel 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
   # already have the repo? check out this version:
   $ git checkout v0.87.0

   • Adds OAuth 2.1OAuth 2.1A 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 SSESSEServer-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.
   • Supports the Claude Channels MCP extension, allowing MCP servers to push real-time notifications into Crush.
   • Supports system-wide configuration via /etc/crush/crush.json, improving NixOS and multi-user deployments.
   • Significant LSPLSPLanguage 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 CPUCPUThe 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.
   • Improves bang-mode output streaming performance by avoiding quadratic shell output rendering.

   5 details in Everything

9. v0.86.0 Jul 20, 2026 · issue 021

   Crush v0.86.0 adds LSPLSPLanguage 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
   # already have the repo? check out this version:
   $ git checkout v0.86.0

   ⤢ ⤢ ⤢ ⤢
   └──▷ TRY IT
   Get aggregate token/cost stats across all sessions or a specific directory tree without opening the TUITUIA 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..
   copy

   $ crush stats --all

   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.
   • Adds lsp_replace_symbol tool: replaces, inserts before/after, or deletes an entire function, method, or class by name via LSP.
   • Enables scrollable sidebar with keyboard (l/h/j/k/g/G/arrows) and mouse-wheel navigation when sidebar content overflows.
   • Adds clickable ✕ button on attachment chips to remove attachments with the mouse.
   • Adds <kbd>u</kbd> keybinding in the OAuth dialog to copy the verification URL — enables authentication over SSH where auto-browser-open is unavailable.

   +2 more show less

   • Adds quit-dialog hint showing that pressing Ctrl+C twice skips the confirmation prompt.
   • Adds --all and --crawl-dir modes to the stats subcommand.

   7 details in Everything

10. v0.85.0 Jul 16, 2026 · issue 017

    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
    # already have the repo? check out this version:
    $ git checkout v0.85.0

    ⤢ ⤢ ⤢
    • Adds a first-class question tool letting LLMsLLMsA 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.
    • Displays an elapsed-seconds timer so you can see how long the LLMLLMA 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.
    • Enables LM Studio vision capabilities (image support) via SupportsImages.
    • Adds automatic transparent auth retry so dropped credentials are refreshed without user intervention.

    4 details in Everything

11. v0.84.0 Jul 10, 2026 · issue 011

    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
    # already have the repo? check out this version:
    $ 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.

    1 detail in Everything

12. v0.83.0 Jul 8, 2026 · issue 009

    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
    # already have the repo? check out this version:
    $ git checkout v0.83.0

13. v0.82.0 Jul 7, 2026 · issue 009

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds Alibaba (United States) as a supported provider region, configurable via ALIBABA_US_API_KEY.

    2 details in Everything

14. v0.81.0 Jun 29, 2026 · issue 001

    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
    # already have the repo? check out this version:
    $ 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).
    • Adds herdr.dev socket integration so herdr can receive agent status signals (blocked/finished) and send notifications.
    • Enables expanding tool-call names in the TUITUIA 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.

    3 details in Everything

15. v0.80.0 Jun 25, 2026 · issue 001

    Crush v0.80.0 adds auto-detection of local model context windowscontext windowsThe 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
    # already have the repo? check out this version:
    $ git checkout v0.80.0

    • Automatically detects context windowcontext windowThe 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.
    • Adds a llamacpp provider enricher, enabling richer model discovery metadata when connecting to llama.cpp servers.
    • Logs provider warnings surfaced from agent step results, making model-side issues visible in the session output.

    3 details in Everything

16. v0.79.0 Jun 19, 2026 · issue 001

    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
    # already have the repo? check out this version:
    $ git checkout v0.79.0

    • Streams Bang Mode command output in real time as long-running commands execute, with a pending spinner while waiting.
    • Enables cancelling a running Bang Mode command mid-execution.
    • Adds copy-to-clipboard for Bang Mode command results (with ANSI codes stripped).
    • Supports prefixing an arbitrary string with Bang Mode to inline shell output directly into a prompt.

    4 details in Everything

17. v0.78.0 Jun 19, 2026 · issue 001

    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
    # already have the repo? check out this version:
    $ git checkout v0.78.0

    ⤢ ⤢
    └──▷ TRY IT
    Run a shell command mid-session and immediately ask the LLMLLMA 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.
    • Enables auto-discovery of local models (Ollama, LM Studio, LiteLLM, MLXMLXApple'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.
    • Adds Fireworks (fireworks.ai) as a supported LLM provider.
    • Improves clipboard support on X11 and Wayland: removes xclip/xsel dependencies, adds TIFF paste support, and enables Super+V / ⌘+V image pasting.

    4 details in Everything

18. v0.77.0 Jun 14, 2026 · issue 001

    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
    # already have the repo? check out this version:
    $ git checkout v0.77.0

    └──▷ TRY IT
    Set a global persona or default preferences (e.g., preferred VCSVCSVersion 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.
    • Adds a name field to hook definitions, making individual hooks identifiable in the CLI output.

    2 details in Everything

19. v0.76.0 Jun 5, 2026 · issue 001

    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
    # already have the repo? check out this version:
    $ 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.
    copy

    $ crush models

    • 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.
    • Expands crush models to list all known providers and their models, not just configured ones — unconfigured providers are marked with (not configured).

    2 details in Everything

20. v0.74.0 May 28, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Supports notifications over SSH terminals, enabling alerts when running Crush on remote hosts.
    • Adds configurable notification backend with bell support and a backend picker UI.
    • Exposes an in-progress flag and connected-client count on session API responses, enabling richer monitoring of active sessions.
    • Server now shares one workspace per directory across all connected clients, reducing duplication in multi-client setups.

    +4 more show less

    • Server broadcasts config changes to all connected clients in real time.
    • Tracks which session each client is currently viewing, enabling per-client session awareness.
    • Auto-closes permission prompts when another client in the same session has already responded.
    • Refuses to open a data directory already in use by another Crush instance, preventing data corruption.

    9 details in Everything

21. v0.73.0 May 26, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.

    1 detail in Everything

22. v0.72.0 May 25, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.72.0

    • Adds ctrl+y keybinding to instantly toggle YOLO mode (with on-screen notification) without opening the command palette.
    • Displays descriptions alongside user-invocable skill commands in the skill picker for easier discovery.
    • Adds a scrollbar to the sessions list dialog for easier navigation of long session lists.
    • Auto-expands the TODO list by default when terminal height is sufficient; toggle with ctrl+t.

    4 details in Everything

23. v0.71.0 May 22, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.71.0

    • Adds support for user-invocable skills, letting users directly invoke defined skills from the chat interface.
    • Requires a permission prompt whenever the model attempts to run Bash commands containing pipes, redirection, or other chained operators.
    • Adds a scrollbar to the model selection list (dialog and onboarding) for easier navigation of long model lists.
    • Defaults AWS Bedrock integration to the us-east-1 region, making all Bedrock models available out-of-the-box without local region configuration.

    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.
24. v0.70.0 May 18, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Extends retry logic to cover network errors (e.g., transient offline states, DNS failures) in addition to HTTP error codes.

    2 details in Everything

25. v0.69.0 May 15, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.69.0

    └──▷ TRY IT
    Use the new -p flag with the dirs command to control directory path output.
    copy

    $ crush dirs -p

    • Adds -p flag to the dirs command for additional directory output control.
    • Adds styling improvements to the dirs command output.

    2 details in Everything

26. v0.68.0 May 14, 2026 · release notes

    Crush v0.68.0 adds an OAuth logout command, MCPMCPModel 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
    # already have the repo? check out this version:
    $ git checkout v0.68.0

    • Adds logout command for OAuth sessions.
    • Adds an allow list for MCP tools, letting you restrict which tools the model can invoke.
    • Automatically mentions gh and rg (ripgrep) in the system prompt when they are available, hinting the model to use them.
    • Extends the prompt templating system to cover more prompt types.
    • Removes the legacy long system prompt option (CRUSH_SHORT_TOOL_DESCRIPTIONS=0 no longer accepted).

    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.
27. v0.67.0 May 11, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Shell expansion now works in config values (e.g., "api_key": "$(vault kv get my/secret/token)") via the embedded interpreter, including MCPMCPModel 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 LSPLSPLanguage 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.
    • New write tool (via touch) lets the model create empty files, gated by a permission prompt for paths outside the working directory.

    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}.
28. v0.66.1 May 8, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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
        }
      }
    }

29. v0.65.2 May 1, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Displays remaining Hypercredits balance in the sidebar so you can track usage at a glance.

    2 details in Everything

30. v0.63.0 Apr 27, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Introduces built-in crush-hook skill to build, manage, and configure hooks from within Crush.
    • Supports Claude Code hooks for compatibility with existing hook scripts.

    3 details in Everything

31. v0.62.0 Apr 22, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.62.0

    • Automatically detects and renders diff-formatted output from any tool (e.g. GitHub MCPMCPModel 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.
    • Short tool descriptions are now the default, saving ~120k tokens per session and improving behaviour of small/local models with limited context windowscontext windowsThe 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..

    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).
32. v0.61.1 Apr 21, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Extends progress bar support to iTerm2, joining Ghostty and Rio as supported terminals.

    2 details in Everything

33. v0.60.0 Apr 17, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.60.0

    • Supports OpenAI-compatible endpoint for the Hyper provider, enabling use of Hyper through standard OpenAI-compatible API tooling.

    1 detail in Everything

34. v0.59.0 Apr 16, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Includes a built-in jq skill to instruct the model on how to invoke jq during agentic tasks.
    • Shows available skills in the sidebar and landing page for improved discoverability.
    • Enables progress bar feedback when running inside Rio Terminal.

    4 details in Everything

35. v0.58.0 Apr 15, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.58.0

36. v0.57.0 Apr 13, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds support for HYPER_API_KEY environment variable for Hyper authentication.
    • The crush_info tool now displays your attribution settings alongside other configuration details.

    3 details in Everything

37. v0.56.0 Apr 8, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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, LSPLSPLanguage 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 MCPMCPModel 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.
    • Adds crush_logs tool: surfaces Crush's own application logs to the model for in-session debugging.
    • Supports disabling either self-diagnostic tool via the disabled_tools config option to prevent the model from ever calling them.
    • Automatically opens the Hyper auth dialog on unauthorized errors, reducing manual intervention when credentials expire.

    4 details in Everything

38. v0.55.0 Apr 2, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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 RPCRPCRemote 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.
    • Supports disabling any skill (built-in, global, or project) via the new disabled_skills array in crush.json.
    • Introduces experimental RPC server-client architecture, enabled with the CRUSH_CLIENT_SERVER=1 environment variable.
    • Serves generated Swagger API docs from the server when running in server-client mode.

    4 details in Everything

39. v0.54.0 Mar 31, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Supports Git's core.excludesfile custom global ignore file when listing project files.

    2 details in Everything

40. v0.53.0 Mar 27, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.53.0

41. v0.52.0 Mar 25, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Sets CRUSH=1, AGENT=crush, and AI_AGENT=crush environment variables when running Bash commands, letting tools detect they are running inside Crush.
    • Improves @-triggered file picker with a significantly better completion ranking algorithm, especially useful in large repositories.
    • Expands Windows global skills path to include ~/.config/crush/skills and ~/.config/agents/skills alongside the AppData location.
    • Improves system prompt to enforce model responses and session titles in the same language as the user's prompt.

    5 details in Everything

42. v0.51.0 Mar 19, 2026 · release notes

    Crush v0.51.0 adds native Docker MCPMCPModel 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
    # already have the repo? check out this version:
    $ 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, ARMARMA 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).
    • Adds crush r and crush s as short aliases for crush run and crush session.
    • Adds --continue flag to resume the last session in both TUITUIA 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.
    • Adds --session <session-id> flag to open a specific past session directly from the CLI or TUI.

    4 details in Everything

43. v0.50.1 Mar 17, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.50.1

    • Adds support for OpenAI GPT-5.4 Mini and GPT-5.4 Nano models.
    • Sets GPT-5.4 Nano as the new default small model for OpenAI.

    2 details in Everything

44. v0.50.0 Mar 16, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Adds --session (-s) flag to crush run to resume a specific session by ID non-interactively.

    2 details in Everything

45. v0.49.0 Mar 13, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.49.0

    • Adds a command-palette (ctrl+p) toggle to enable/disable background color (transparent mode), persisted across sessions.
    • Supports pasting AWS Bedrock API keys directly in the provider input, alongside the existing environment-variable method.
    • 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).

    3 details in Everything

46. v0.48.0 Mar 12, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.48.0

    • Adds desktop notifications on turn completion and permission requests, with an in-app toggle.
    • New crush session list command to browse past sessions from the CLI.
    • New crush session <id> command to inspect a former session in full; supports --json for structured outputstructured outputForcing 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.
    • Supports renaming and deleting sessions from the CLI via crush session.
    • Crush now presents a Charm-Crush/<version> User-Agent header on all network requests, making it identifiable in observability and proxy tools.

    5 details in Everything

47. v0.47.2 Mar 5, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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).
    • Adds Zhipu and Zhipu Coding (bigmodel.cn) as new AI providers.
    • Adds QiniuCloud as a new AI provider.

    3 details in Everything

48. v0.47.0 Mar 4, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.47.0

49. v0.46.0 Feb 26, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.46.0

    • Adds MiniMax China as a new provider, using the China-specific endpoint for Chinese users.
    • 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.

    2 details in Everything

50. v0.45.0 Feb 24, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.45.0

    • Adds GPT-5.3 Codex as a selectable model via the model picker.
    • Adds granular thinking-level selection for Gemini 3 and 3.1 (replaces the previous on/off toggle).

    2 details in Everything

51. v0.44.0 Feb 22, 2026 · release notes

    Crush v0.44.0 adds visual confirmation when skills are loaded so you know the LLMLLMA 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
    # already have the repo? check out this version:
    $ git checkout v0.44.0

    • Adds UI indicator showing when a skill is actively loaded, distinguishing real skill execution from LLM improvisation.

    1 detail in Everything

52. v0.43.0 Feb 13, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.43.0

    • Adds a toggle todos/pills menu item to the UI.
    • Replaces regex-based gitignore parsing with glob-based matching, reducing CPUCPUThe 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.

    2 details in Everything

53. v0.42.0 Feb 11, 2026 · release notes

    Crush v0.42.0 adds GLM 5 via z.AI and surfaces user-configured LSPLSPLanguage 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
    # already have the repo? check out this version:
    $ git checkout v0.42.0

    • Adds GLM 5 model support via z.AI as a new provider option.
    • Shows user-configured LSP servers in the UI with an unstarted status before they are invoked.

    2 details in Everything

54. v0.41.0 Feb 9, 2026 · release notes

    Crush v0.41.0 adds in-TUITUIA 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
    # already have the repo? check out this version:
    $ 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.
    • Supports OAuth2OAuth2An 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.

    2 details in Everything

55. v0.40.0 Feb 9, 2026 · release notes

    Crush v0.40.0 adds on-demand LSPLSPLanguage 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, MCPMCPModel 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
    # already have the repo? check out this version:
    $ 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.
    • Supports MiniMax as a new AI provider, including the MiniMax Coding Plan.
    • Adds MCP resources support.
    • Enables clipboard image paste via Ctrl+V.

    4 details in Everything

56. v0.39.0 Feb 3, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.39.0

    • Adds Up/Down arrow key history navigation to cycle through past prompts, similar to Bash and VSCode.
    • Enables renaming sessions with Ctrl+R and deleting sessions with Ctrl+X from the session dialog.
    • Supports click-to-expand/collapse for code blocks, diffs, and thinking blocks in the chat.
    • Shows last-updated time for each session in the sessions dialog.
    • Displays the active provider name in the sidebar, panel, and message footers.

    +2 more show less

    • Adds transparent mode for the UI.
    • Adds a configurable timeout for LSPLSPLanguage 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.

    7 details in Everything

57. v0.38.0 Feb 2, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.

    1 detail in Everything

58. v0.37.0 Jan 30, 2026 · release notes

    Crush v0.37.0 adds LSPLSPLanguage 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, MCPMCPModel 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
    # already have the repo? check out this version:
    $ 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.
    • Supports MCP server-side instructions for richer model-context-protocol integrations.
    • Adds prompt history so previous inputs can be recalled during a session.
    • Expands available Copilot models, including Gemini 3 Pro (Preview) and Gemini 3 Flash (Preview).
    • Opens the commands dialog by pressing / for faster command access.

    +3 more show less

    • Adds per-session file tracking to scope file awareness to the current session.
    • Enables disabling the indeterminate progress bar via configuration.
    • Previews a new UI, accessible by setting CRUSH_NEW_UI=1 in the environment.

    8 details in Everything

59. v0.36.0 Jan 27, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    copy

    $ crush stats

    • New crush stats command displays a per-project usage dashboard with token and session statistics.
    • Adds ability to delete sessions directly from the UI.
    • Enables renaming/updating session titles.
    • Supports drag & drop of multiple files at once, including on Windows.

    4 details in Everything

60. v0.35.0 Jan 23, 2026 · release notes

    Crush v0.35.0 adds Vercel AI Gateway support, an LSPLSPLanguage 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
    # already have the repo? check out this version:
    $ 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.
    • Adds lsp_restart command to restart the language server from within Crush.
    • Adds a keybinding to copy chat message content to clipboard.
    • Previews a new UI refactor accessible via CRUSH_NEW_UI=1, including an onboarding flow.

    4 details in Everything

61. v0.34.0 Jan 21, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • New crush models command lists all configured models and providers, composable with grep.
    • Supports sending prompts with file attachments even when the text body is empty.
    • Adds attachment support: files can be attached to prompts in interactive mode.
    • Adds paste-as-file capability, turning large pastes into attachments automatically.

    +5 more show less

    • New completions menu for the editor input.
    • Expandable thinking display for assistant responses in chat.
    • File picker dialog with image preview and Kitty graphics protocolKitty graphics protocolA 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).
    • Terminal tab title is now set automatically to reflect the working directory.
    • New opt-in overhauled UI available via CRUSH_NEW_UI=1 environment variable.

    10 details in Everything

62. v0.33.2 Jan 16, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.33.2

63. v0.32.0 Jan 12, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Enables sending a prompt that contains only file/text attachments with no typed text.

    2 details in Everything

64. v0.31.0 Jan 7, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.31.0

    • Supports loading skills from a shared ~/.config/agents/skills directory, enabling reuse across multiple agent tools.

    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.
65. v0.30.3 Jan 5, 2026 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.30.3

    • Adds Claude Opus 4.5 as a selectable model for GitHub Copilot users.
    • Adds GPT 5.2, GPT 5.1, GPT 5.1 Codex, and GPT 5.1 Max as selectable models for GitHub Copilot users.

    2 details in Everything

66. v0.30.0 Dec 27, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.30.0

    • Supports the Agent Skills open format, enabling on-demand agent capability extensions that load automatically without cluttering context.

    1 detail in Everything

67. v0.29.0 Dec 19, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.29.0

    • Supports dragging and dropping attachments of all kinds directly into the terminal UI.
    • Automatically treats large pasted text as an attachment instead of inline input.

    2 details in Everything

68. v0.28.0 Dec 18, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.28.0

    • Adds ability to set environment variables to override config directories.
    • Enables Hyper and GitHub Copilot login directly through the onboarding flow.

    2 details in Everything

69. v0.27.0 Dec 17, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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 TUITUIA 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..
    • New crush login copilot command for explicit GitHub Copilot authentication.

    2 details in Everything

70. v0.26.0 Dec 16, 2025 · release notes

    Crush v0.26.0 adds Hyper terminal integration.

    └──▷ GET THIS VERSION

    copy

    $ git clone --branch v0.26.0 https://github.com/charmbracelet/crush.git
    # already have the repo? check out this version:
    $ git checkout v0.26.0

71. v0.25.0 Dec 16, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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.

    1 detail in Everything

72. v0.24.0 Dec 12, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Enables input/output redirection and piping in crush run non-interactive mode, allowing integration with shell pipelines.

    2 details in Everything

73. v0.23.0 Dec 11, 2025 · release notes

    Crush v0.23.0 adds GPT-5.2 and GPT-5.1 Codex Max support, plus MCPMCPModel 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
    # already have the repo? check out this version:
    $ 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.
    • Adds support for GPT-5.1 Codex Max model.
    • New disabled_tools list in MCP config lets you suppress specific MCP tools without removing the server.
    • Shows a / hint in the TUITUIA 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.

    4 details in Everything

74. v0.22.2 Dec 10, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.22.2

    • Sorts sessions by most recently used activity instead of creation time in the Ctrl+S session dialog.

    1 detail in Everything

75. v0.22.0 Dec 8, 2025 · release notes

    Crush v0.22.0 adds DuckDuckGo web search and image-returning tool/MCPMCPModel 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
    # already have the repo? check out this version:
    $ 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.
    • Supports image results returned by tools and MCPs (e.g., Playwright), enabling visual web agentic workflows.

    2 details in Everything

76. v0.21.0 Dec 4, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.21.0

    • Enables parallel tool calls so multiple tools can execute simultaneously, reducing wait time on multi-step tasks.
    • Adds progress bar display for iTerm2 and Rio terminal emulators.

    2 details in Everything

77. v0.20.1 Dec 1, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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

78. v0.19.0 Nov 26, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.19.0

    • Supports Claude Code Max subscriptions — select an Anthropic model and Crush will prompt you through the authentication flow.

    1 detail in Everything

79. v0.18.4 Nov 19, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.18.4

80. v0.18.3 Nov 19, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.18.3

    • Adds support for Google Gemini 3 across models hosted on Google and OpenRouterOpenRouterA 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..
    • Notifies users in-app when a new version of Crush is available.

    2 details in Everything

81. v0.18.2 Nov 17, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.18.2

    • Supports Mode 2026 terminal rendering synchronization via Bubble Tea v2, delivering smoother UI updates in compatible terminals.
    • Defaults commit/output attribution to assisted-by mode.

    2 details in Everything

82. v0.18.1 Nov 13, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.18.1

83. v0.18.0 Nov 13, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.18.0

84. v0.17.0 Nov 12, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.17.0

    • Adds a recent models section at the top of the model picker so frequently used models are surfaced automatically.
    • 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.
    • Migrates the deprecated co_authored_by config setting to the new attribution scheme.

    3 details in Everything

85. v0.16.0 Nov 7, 2025 · release notes

    Crush v0.16.0 adds background jobs so the LLMLLMA 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
    # already have the repo? check out this version:
    $ git checkout v0.16.0

    └──▷ BREAKING ON UPGRADE

    • !Persistent shell has been removed.
86. v0.15.2 Nov 6, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.15.2

    • Adds Ctrl+L and Ctrl+M keyboard shortcuts to open the model switcher without leaving the keyboard.

    1 detail in Everything

87. v0.15.0 Nov 5, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • Press / in an empty textarea to open the command palette (in addition to the existing ctrl+p shortcut).
    • Use @ to open the file picker in the chat input.

    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.
88. v0.14.0 Nov 4, 2025 · release notes

    Crush v0.14.0 adds MCPMCPModel 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
    # already have the repo? check out this version:
    $ git checkout v0.14.0

    • Supports MCP stored prompts (templates): access via ctrl+p then the MCP tab in the command prompt.
    • Shows a progress bar loading feedback during startup on Ghostty and Windows Terminal.

    2 details in Everything

89. v0.13.7 Oct 31, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.13.7

    • Enables full OpenAI feature set for Azure-hosted models, including reasoning effort levels (Low, Medium, High).
    • Significantly faster rendering and lower CPUCPUThe 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.

    2 details in Everything

90. v0.13.0 Oct 27, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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"
        }
      }
    }

91. v0.12.0 Oct 21, 2025 · release notes

    Crush v0.12.0 adds LSPLSPLanguage 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 TokenBearer TokenA 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
    # already have the repo? check out this version:
    $ 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.
    • Supports AWS_BEARER_TOKEN_BEDROCK environment variable for authenticating with AWS Bedrock.

    2 details in Everything

92. v0.11.0 Oct 13, 2025 · release notes

    Crush v0.11.0 adds terminal progress bar support, MCPMCPModel 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
    # already have the repo? check out this version:
    $ git checkout v0.11.0

    • Adds application-level progress bar display in supporting terminals (Windows Terminal, Ghostty).
    • Adds MCP notifications support including tools/list_changed events, enabling real-time tool updates to MCP clients like Neovim.
    • Adds automatic filepath walk limits, with lower limits applied automatically when not in a git repository.

    3 details in Everything

93. v0.10.4 Sep 30, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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)"

94. v0.10.0 Sep 24, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.10.0

    • Adds Hugging Face inference provider integration.
    • Supports custom providers of type gemini in config.
    • Searches crush.json recursively up from the working directory.
    • Loads LSPLSPLanguage 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.
    • Pretty-prints MCPMCPModel 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.

    +2 more show less

    • Adds alt/option+esc key binding as an alias for the existing esc behavior.
    • Adds pseudoanonymous usage metrics (device hash only; prompts and responses never collected) with opt-out support.

    7 details in Everything

95. v0.9.0 Sep 17, 2025 · release notes

    Crush v0.9.0 overhauls LSPLSPLanguage 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
    # already have the repo? check out this version:
    $ git checkout v0.9.0

    • Rewrites LSP implementation using the Power Nap library, reducing codebase complexity and improving LSP experience.
    • Adds attribution settings to config and bash tool, allowing users to disable Crush attribution in commit messages.

    2 details in Everything

96. v0.8.0 Sep 12, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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.
    • New crush update-providers command lets practitioners manually pull provider/model updates from Catwalk, a custom URL, a local file, or the embedded bundle.
    • 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.
    • New disabled_tools config option lets users selectively block individual agent tools (e.g., bash, fetch, write) from being available to the model.
    • Model chooser now supports multi-word search and matches on provider name, making it easier to locate a specific model by provider.

    5 details in Everything

97. v0.7.9 Sep 10, 2025 · release notes

    Crush v0.7.9 cuts LSPLSPLanguage 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
    # already have the repo? check out this version:
    $ git checkout v0.7.9

    • Optimizes LSP file watcher with 99% reduction in file descriptors, improving performance when using multiple LSPs.

    1 detail in Everything

98. v0.7.8 Sep 9, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ git checkout v0.7.8

    • Enables bracketed paste on Windows, allowing multiline text to be pasted correctly.
    • Enables SQLite secure_delete pragma so deleted database records are securely overwritten.

    2 details in Everything

99. v0.7.5 Sep 5, 2025 · release notes

    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
    # already have the repo? check out this version:
    $ 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.

    1 detail in Everything

100. v0.7.2 Aug 27, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ git checkout v0.7.2

     • Supports configuring a custom Anthropic base URL option for routing API traffic through proxies or compatible endpoints.
     • Displays the current directory path when prompting to initialize a new project.

     2 details in Everything

101. v0.7.0 Aug 20, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ 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.
     • Automatically discovers a .crush directory in any parent directory, similar to how git locates .git, so subdirectory work reuses the project's data dir.

     2 details in Everything

102. v0.6.3 Aug 18, 2025 · release notes

     Crush v0.6.3 adds LSPLSPLanguage 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
     # already have the repo? check out this version:
     $ git checkout v0.6.3

     • Supports setting custom environment variables for LSP servers via config.
     • Automatically creates a .crush/.gitignore so the workspace directory is excluded from Git without manual intervention.
     • Removes go from the list of safe programs the model is allowed to run, narrowing the permitted command surface.
     • Compiled with Go's GreenTea Garbage Collector, reducing memory footprint and CPUCPUThe main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. usage.

     4 details in Everything

103. v0.6.2 Aug 15, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ git checkout v0.6.2

104. v0.6.1 Aug 14, 2025 · release notes

     Crush v0.6.1 adds configurable MCPMCPModel 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 LSPLSPLanguage 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
     # already have the repo? check out this version:
     $ 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.
     • Enables automatic MCP client ping and reconnection when an MCP server becomes unresponsive.
     • Supports restricting LSP servers to specific file types via a filetypes config key for improved efficiency.
     • 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.

     4 details in Everything

105. v0.6.0 Aug 13, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ git checkout v0.6.0

106. v0.5.0 Aug 11, 2025 · release notes

     Crush v0.5.0 adds configurable default diff mode (unified or split) via the TUITUIA 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
     # already have the repo? check out this version:
     $ 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"
         }
       }
     }

107. v0.4.0 Aug 8, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ git checkout v0.4.0

     └──▷ TRY IT
     Start a session with all permission dialogs bypassed from the command line.
     copy

     $ crush --yolo

     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.
     • Enables mouse scrolling in the diff view.
     • Ships built-in coreutils (base64, gzip, mktemp, shasum, tar) on Windows — and speeds them up on all platforms by eliminating shell-outs.
     • Supports CRUSH_-prefixed environment variables (e.g. CRUSH_ANTHROPIC_API_KEY) to scope secrets to Crush without clobbering default env vars.

     4 details in Everything

108. v0.3.0 Aug 7, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ git checkout v0.3.0

     • Adds mouse-based text selection in chat messages, including double-click to select and copy.
     • Supports drag-and-drop image input into the chat from almost any terminal, including Apple Terminal.
     • Adds out-of-the-box support for GPT-5 as an OpenAI provider.
     • Supports minimal reasoning mode for OpenAI reasoning models.
     • Available on Nixpkgs unstable for easier installation.

     5 details in Everything

109. v0.2.2 Aug 6, 2025 · release notes

     Crush v0.2.2 adds JetBrains rendering support, Scoop distribution for Windows, and LSPLSPLanguage 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./MCPMCPModel 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
     # already have the repo? check out this version:
     $ 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.
     • Adds Scoop package distribution for easy installation on Windows.
     • Adds LSP and MCP status indicators in the UI showing offline, starting up, online, and error states; full details viewable via crush logs.
     • Adds Escape key as an additional way to deny prompts in the UI.

     4 details in Everything

110. v0.2.0 Aug 2, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ 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.
     • Extends --debug mode to also log provider request/response details, stored in .crush/logs/crush.log and viewable via crush logs.
     • Applies .crushignore and .gitignore rules to the built-in grep tool, scoping searches consistently with context exclusions.

     3 details in Everything

111. v0.1.6 Jul 29, 2025 · release notes

     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
     # already have the repo? check out this version:
     $ git checkout v0.1.6

     • Introduces Crush, a new terminal-native AI coding assistant CLI from Charmbracelet.
     • Supports release artifact verification via cosign and sha256sum for supply-chain integrity.

     2 details in Everything