Crush

Tiny patch

This is a tiny release, but we thought it would be worth it.

• Updated Bubble Tea with a couple fixes for some terminal emulators.
• Updated Fantasy with fixes for AWS SSO and better cache hitting.
• Fixed wrong background color on permissions dialog. This was a regression from adding Bash syntax highlighting on v0.89.0.
• Updated our .gitattributes to make development easier on Windows. We're normalizing LF (instead of CRLF) as line breaks to fix some tests on Windows.

Changelog

Fixed

• ed15da4c46e0bdc3afae4842db54e7def7b9f15e: fix(ui): use dialog background for bash syntax highlighting in permissions (#3575) (@andreynering)

Other stuff

• 0f14334fb03703a5557f875d182e347e6375e0e7: chore: normalize line endings to lf via .gitattributes (#3555) (@Lin-BoYuan)

A couple QoL goodies

We're releasing a few Quality of Life :tm: enhacements for you. They're simple, but these simple improvements compound with time to make Crush better and better.

Hint on quitting Crush

When quitting Crush, you'll see a splash screen with a hind on how to quickly continue from the session you left.

Bash tool syntax highlighting

When displaying what Crush is running using the Bash tool, the shell command will now have syntax highlighting. It's a small addition, but definitely improves legibility.

Moo :cow:

ctrl+end to jump to bottom + follow

If you want to quickly jump to the bottom of the chat, you can now just press <kbd>ctrl+end</kbd>. This will also ensure Crush will follow the chat as new messages arrive.

MCP improvements

We enhanced things to make it more stable and fix a couple of edge-case bugs.

It’s Time for a Bugfix Throwdown

This release is all about stability and quality of life with a buncha fixes around MCP, server-client, and odds and ends. Here's what’s inside:

• UX: Typing clear in the command will match Summarize; thanks, @joestump!
• LSP: @piakdev fixed a case where LSP could panic
• MCP: Slow loading MCPs could block messages from being sent: we reduce default timeout
• Server-Client: MCP OAuth didn't work in server-client mode; now it does
• Server-Client: Clients in the same workspace could kill each other: not anymore
• Server-Client: When the server is running over TCP keystrokes no longer hit the server and slow everything down
• Hyper: Added various small improvements for better UX

Thanks for using Crush. Have good weekend! Charm 💌

Changelog

New!

• cfad8143fc0414d1406a8b846708a43ee511a757: feat(dialog): alias clear to summarize in command palette (#3464) (@joestump)

Fixed

• bdad0f11cd6a279548c9458349fec313cbbea4fb: fixmcp): don't hold callback port open permanently (#3481) (@taciturnaxolotl)

.crushrc is here!

Hey! Hope everybody had a great week. We were pretty productive at Charm and we're releasing some cool stuff today.

Bash configuration! (.crushrc)

Yep, .crushrc has come! You existing JSON config still works, but we just started migrating to something a lot more flexible!

An example on why this is cool: if you manage Crush config in a dotfiles repo, you can still have machine-specific overrides by using source to call a separate file that will be in your .gitignore. I'm sure there are many other use cases.

To read the full documentation on this, read this document.

See a snipped so you have an idea on how it looks:

# 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 some tools.

permissions allow view edit

# Add an MCP server

mcp add github \
  --type http \
  --url "https://api.githubcopilot.com/mcp/" \
  --header Authorization "Bearer $GITHUB_TOKEN"

# Load some extra config

source "$XDG_CONFIG_HOME/squid-config.sh"

MCP OAuth, performance and more

Happy Friday everybody!

We're releasing some nice features for you so you can enjoy your weekend vibecoding. (Or not, stay outside :sun_with_face: and return to Crush on Monday! :smiley:).

MCP OAuth

That's it, it's finally here! Some of you have been asking for this for long.

This is required for some MCPs to work. Want to know to it set it up? Refer to this section into the README.

Thank @joestump and his agent @joestump-agent for this contribution. And of course, our favorite @taciturnaxolotl also helped.

Claude Channels MCP extension

@joestump (and his agent) also added an initial implementation to support the Claude Channels MCP extension, which means MCPs can now send notifications to Crush when certain events happen.

Give this a try if you're interested, and let us know how well it works for you.

Restored MCP prompts

MCP prompts were unintentionally disabled in a previous release, but they were now added back!

LSP performance boost

LSP tools, scrollable sidebar, removable attachments + more

Hey all. We're starting the week in style by shipping some LSP stuff and more goodies.

Brand new LSP tools

These new LSP tools will allow the model to more accurately do some refactors:

• lsp_rename - Rename a symbol and all its references in the project
• lsp_replace_symbol - Replace, insert before/after, or delete an entire function/method/class by name

If something doesn't work as expected by the LSP, don't worry. We'll report an error to the model so it can fallback to using the edit tool.

Scrollable sidebar

This one is pretty cool. Got out-of-space in your sidebar? Don't worry, you can scroll its content now!

Keyboard:

• When focused on the chat view: <kbd>l</kbd> or <kbd>right arrow</kbd> focuses on the sidebar
• <kbd>j/k</kbd> or <kbd>up/down arrow</kbd> scrolls up and down
• <kbd>g</kbd> scrolls to top <kbd>shift+g</kbd> scrolls to the bottom
• <kbd>h</kbd> or <kbd>left arrow</kbd> focuses back on the chat view
• <kbd>tab</kbd> always returns focus to the editor

If you have questions, we have answers

This release brings us a question tool (at last!) plus a bunch of bugfixes and niceties. Let's go!

The Question Tool

So! Crush now ships with a first class question tool, useful for when LLMs wanna grill you. The question tool comes in many forms, like single choice, multiple choice, free form text, and yes/no. Questions can be ganged together to build a form, too.

What’s that you say? “Does it have mouse support?” Why, yes it does.

What is this sorcery? Only @taciturnaxolotl knows. He solo’d this whole feature exclusively with open source models on Hyper.

Hurry up and wait

Ever put an LLM to work, only to forget about it and come back and wonder how long it's been cranking? @andrinoff sure did. Wonder no more.

And so much more

Session affinity, for real this time

This bumps Fantasy upstream, which was missing in the last release to actually send session id headers in the last revision.

Enjoy! Charm 💘

Changelog

• https://github.com/charmbracelet/crush/pull/3282/changes/5a7899eeba613ca0ddf3c03fdcf227cec0f85f36 chore(deps): bump fantasy (0.35.2 -> 0.36.0) (@coloryourlife)

First, download the checksums.txt file and the checksums.txt.sigstore.json file files, for example, with wget:

wget 'https://github.com/charmbracelet/crush/releases/download/v0.84.1/checksums.txt'
wget 'https://github.com/charmbracelet/crush/releases/download/v0.84.1/checksums.txt.sigstore.json'

Then, verify it using cosign:

cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \

If you like caching and coding on your Android, you’ll love Crush v0.84.0

This is a mini release with two little niceties:

Cachemaxxing

Crush now sends the fabled x-session-affinity header (and x-session-id) in its requests. Supporting providers can pick the header up, pin the session to a given replica, and go cache wild. The session header is a hash with no personally identifiable information, of course.

Fixed: Termux

If you’re a nerd with an Android, you probably use Termux, the hot Android terminal emulator. If you’re a cool nerd, you probably want to use Crush on an Android and are annoyed that it was broken. Thanks to @Ricardo-M-L, Crush now works on Android again.

Hope you're having a great summer! Unless you're in South America, Central America, the Southern part of Mexico, parts of Africa or Australia, in which case…hope you're enjoying the Winter!

xoxo, Charm 🍔

Changelog

New!

• ebd845c003579484171922fda8a671367eee7684: feat(agent): send session hash in header for cache affinity (@meowgorithm)

Fixed

• 5b61432984ba271cf9cb3791295ba94e9c2c8f81: fix(release): drop broken .termux.deb artifact (#2848) (@Ricardo-M-L)

Prep for GPT-5.6

GPT-5.6 should launch tomorrow, and this release is to ensure Crush is ready for when it happens.

Bang mode fix

We also included a UX small fix when navigating the history when previous prompts were Bash commands (using bang mode :tm:).

Charm 💘

Changelog

New!

• d0dc9fc9dfce76b9e35b2686ee4bfccfca796222: feat: prepare for gpt-5.6 (#3270) (@andreynering)

Fixed

• cb1292026cc113e2a2e61f14686f2a36551f74a0: fix(bangmode): don't add extra ! when browsing history (@meowgorithm)

Other stuff

• 72c5668eface73b6e3745cccc8098f2cd1e55879: system prompt: avoid emdashes in source code (@meowgorithm)

First, download the checksums.txt file and the checksums.txt.sigstore.json file files, for example, with wget:

wget 'https://github.com/charmbracelet/crush/releases/download/v0.83.0/checksums.txt'
wget 'https://github.com/charmbracelet/crush/releases/download/v0.83.0/checksums.txt.sigstore.json'

General fixes

Hello. This small patch includes some varied fixes.

Better chat scroll

On some rare occasions, the chat could stop scrolling automatically to the bottom as the model works. We made some changes to make this more reliable!

General agent fixes

There were a few fixes here and there making the agent behave better. We made thinking on/off and reasoning levels behave better for providers like Alibaba and Baseten, for example.

We are finally mentioning Hyper on README, which are our favourite inference service for Crush.

See ya!

Changelog

New!

• cbb6daaa80841614abc091f3201c5e635895c22e: feat(ui): preserve newlines in expanded tool content (#3239) (@taciturnaxolotl)

Fixed

• d341d84b24fbe6471708c15f4dc08533a9ea6dc4: fix(alibaba): fix missing thinking traces on deepseek via aliababa (#3259) (@andreynering)

• 3ac7f1c48bbe3031772fb2f47c2f356283790591: fix(baseten): make the thinking on/off toggle work for baseten (@andreynering)

• 78a205cdb5f988aa6daa6c1907e88b4b9d2b2769: fix(copilot): guard nil request body in initiator transport (#3246) (@truffle-dev)

Some UX stuff for ya

We're starting the week in good style by adding some nice additions and improvements.

Chat scrollbar

This is it, the chat just got a scrollbar! This should make your life easier on navigation long session. You can now see exactly where you are when scrolling.

It's possible to adjust the behavior with a setting: options.tui.scrollbar.

• default (hides after 2 seconds)
• always
• never

{
  "options": {
    "tui": {
      "scrollbar": "default" // default, always, never
    }
  }
}

https://github.com/user-attachments/assets/c0c0f888-78d4-4457-ae32-eb1a2dd5f575

Herdr Support

Have you been wanting to use herdr.dev for all your agent management needs? Well now its even better! @taciturnaxolotl merged support for agent status signaling so now herdr can pick up on the status of crush and send you notifications when it is blocked or finished!

Lower CPU usage

The Ol’ Thursday Patch

Hi all! It's patch time, and time for some bonus features. Let's go!

Fixin’ broken tool calls

Occasionally a model will opt to do a tool call with invalid arguments (invalid JSON), the session was just breaking, and even new prompts wouldn't anymore. We're now validating the issue and reporting it as an error to the model so it can correct itself. Of course, we also fixed the associated bug in Crush so sessions will no longer break.

Local models: auto-detectin’ context windows

Who loves local models? Now, Crush will now automatically detect models context windows with you add an endpoint for llamacpp, omlx, lmstudio, litellm, and ollama. Prior to this it was mis-setting window sizes to zero.

Config: harder, faster, stronger

Okay maybe not harder. But config in Crush is definitely faster and stronger.

We refactored on the so it's way more performant and safe for big, long configs where there are many providers, models, and so on. This also means that the model picker dialog will load faster too! We also added some safeguards to prevent race conditions when multiple Crush

Bang Bang

This release introduces a number of small but mighty UX improvements to improve the Bang Mode experience overall. Details below.

Hope you’re chilling out, Charm 💘

Changelog

Fixed

• 11662010521e5211d825fcc21c4fdf8c72fda08e: fix(bangmode): activate bang mode when ! is preceded by whitespace (@meowgorithm)
• 7e4bd6a0b44ce3c32f0e36d48ffcd77c1955d641: fix(bangmode): engage bang mode when pasting text starting with ! (@meowgorithm)
• f342edf052ef1ca35fb202c235a976b9ef6f45f9: fix(bangmode): include bang commands in history (@meowgorithm)
• d20e29ae75004991e801fc4fd18c83e68913b5ab: fix(bangmode): sync bang mode with external editor (@meowgorithm)

First, download the checksums.txt file and the checksums.txt.sigstore.json file files, for example, with wget:

wget 'https://github.com/charmbracelet/crush/releases/download/v0.79.1/checksums.txt'

More Bang Mode™ improvements

This morning we released the new Bang Mode. For this release, we did a couple small fixes and enhancements to it:

• We tweaked the font colors to make it more legible;
• A long-running command will now show immediately and stream output as the command runs;
• Session name generation is fixed for sessions started with a command.

Agent bug fixes

We made a few bug fixes to Fantasy to make Crush behave better with certains providers and models.

• The tool not found error now print the list of available tool. This is targeting certain models like Kimi that sometimes can get lost and call tools that doesn't exist;
• Fixes potential tool call errors with the GLM family via Fireworks;
• Fixed some GPT models via Azure (thanks @dustinlagoy);
• Fixes Gemini via VertexAI (thanks @eswar-7116);
• Fixed tool calls sometimes not working properly for local models.

Have a great weekend and keep crushing! :rocket: The Charm Team

Changelog

New!

• 1c2da8930cdf77c0cff1ba8014028b4ec31f5f82: feat(bang): remap ansi 16 colors (@taciturnaxolotl)