Channels, custom prompts and a sturdier server!
MCP servers can now push events straight into your session, every one of Crush's prompts can be swapped for your own, and the server got a top-to-bottom tune-up.
Channels (experimental)
MCP servers can now do more than wait to be called. A channel pushes events into your session as they happen.
Example:
crush --channels server:webhook --channels server:signalOr turn one on permanently in your crushrc:
mcp add webhook --type http --url https://example.com/mcp --channel trueCrush speaks the same protocol as Claude Channels, so existing channel servers should just work.
Bring your own prompts
Every built-in prompt can now be replaced with your own file: the main agent, subagents, planning, compaction, session titles and crush init.
option prompt coder ~/.config/crush/prompts/coder.md.tpl
option prompt summary prompts/summary.mdSet them globally, override them per project, or try one out for a single run with --prompt name=path.
A sturdier server
The server got a big round of patching. It's now more secure, as it's locked to your user, protected from cross-site requests, and never shares an address with other people on the same machine. It's also more reliable: crashed servers come back on their own, workspaces don't step on each other, and shutdowns finish what they started. crush run now stops cleanly when you interrupt it and fails loudly when the server goes away. Windows users get a hidden console and fewer surprises.
Pretty new looks 🎨
New themes
KITT, plus Rosé Pine in all three flavors: classic, Moon and Dawn.
Nerd Fonts
Support is detected automatically! Crush now uses their icons, LSP status and Git included. Running over SSH? Set it yourself with option ui nerd-fonts true.
Small updates!
- Sysadmin mode is no longer one Shift+Tab past yolo.
- Queued prompts show up in the pill the moment you submit them.
- The model can use
sudo, so you can approve with Touch ID. - Content refusals are retried automatically.
- Sessions that Claude kept rejecting work again.
- Ollama models that can't call tools no longer show up in the model list.
- Commands that leave child processes behind no longer hang.
- Timers tick together, and running tool timers keep going until the tool replies.
- Switching themes no longer re-renders the whole conversation.
- Deleting a session keeps your place in the list.
- Replayed messages keep their whitespace, and plan cards line up properly.
Good luck,
Charm XX 🌤️
Changelog
New!
- 01780cc: feat(lsp): Automatically use nerd font for LSP status (#4334) (@BrunoKrugel)
- 60c5457: feat(ui): Claude Channels TUI (#3347) (@joestump-agent)
- 0a3d112: feat(ui): show a queued prompt in the pill as soon as it is submitted (#4307) (@taciturnaxolotl)
- d43bf2c: feat: add a built-in
kitttheme (#4279) (@cdancy) - 498c44f: feat: add custom prompt paths (#4141) (@andrinoff)
- 0d7895c: feat: automatic nerd font detection (#4006) (@andrinoff)
Fixed
- 72979db: fix(agent): let the model use sudo so Touch ID and other PAM approvals work (@taciturnaxolotl)
- 945be07: fix(agent): report a session busy while a sub-agent or accepted run holds it (#3921) (@taciturnaxolotl)
- f64fe8e: fix(agent): retry content refusals (@taciturnaxolotl)
- 4eb49b9: fix(agent): send one result per tool call so Claude accepts the session (@taciturnaxolotl)
- 6643519: fix(discover): leave out Ollama models that can't call tools (#4327) (@janearc)
- 2923a2f: fix(server): arm idle shutdown as soon as the server is listening (@andrinoff)
- 2a8a475: fix(server): auto-approve permissions for crush run's session (@andrinoff)
- 6808c85: fix(server): block dns rebinding and cross-site tcp requests (@andrinoff)
- b54beb6: fix(server): bound client shutdown on an unresponsive server (#4170) (@andrinoff)
- a8aa837: fix(server): bound the spawn lock wait and honor cancellation (@andrinoff)
- 369d8e8: fix(server): cancel a run when the last client viewing it leaves (#4167) (@andrinoff)
- 57489c0: fix(server): cancel crush run's own question batch by id (@andrinoff)
- 1b1bf12: fix(server): cancel in-flight requests on graceful shutdown (@andrinoff)
- 18b362b: fix(server): cancel the server run when crush run is interrupted (@andrinoff)
- 77e8154: fix(server): carry the provider ID in reauthentication events (#4277) (@gulagala001)
- affd107: fix(server): decode mcp and replace_symbol permission params (@andrinoff)
- 5d0e06d: fix(server): dedupe workspaces and db by directory identity (@andrinoff)
- ac835ac: fix(server): detect git repos in the workspace dir, not the server cwd (@andrinoff)
- f386b37: fix(server): end event streams that fell behind so clients resync (@andrinoff)
- 844565d: fix(server): escape uri metacharacters in sqlite dsn paths (@andrinoff)
- b03632b: fix(server): exit 128+signal number instead of always 130 (@andrinoff)
- 2a8be16: fix(server): fail crush run when the server drops or cancels the run (@andrinoff)
- d59e324: fix(server): ignore sighup during graceful shutdown (@andrinoff)
- 46461fb: fix(server): keep clients out of the server's log file (#4169) (@andrinoff)
- f338539: fix(server): keep the previous server's crash log on respawn (@andrinoff)
- 629cec3: fix(server): keep the shared agent coordinator when clients join (@andrinoff)
- 7336e3e: fix(server): kill only a workspace's own shells on teardown (@andrinoff)
- aa68b2c: fix(server): lock one byte on windows to keep owner info readable (@andrinoff)
- 97ec3f5: fix(server): lock projects.json across processes (@andrinoff)
- 1524f7f: fix(server): make concurrent pubsub broker shutdown idempotent (#4166) (@andrinoff)
- 0ed6dcf: fix(server): never share the default server address between users (@andrinoff)
- 3c8a53b: fix(server): only unlink the socket this server bound (@andrinoff)
- a8f0ec0: fix(server): probe the named pipe instead of stat'ing it (@andrinoff)
- 328d481: fix(server): reap a detached server that exits before its client (@andrinoff)
- 8ec14d7: fix(server): refuse a server socket or pipe owned by another user (@andrinoff)
- 28216ad: fix(server): register projects opened through the server (@andrinoff)
- b6619e8: fix(server): replace exiting servers on named pipes and tcp (@andrinoff)
- 4eadcd5: fix(server): resolve a relative --cwd before sending it to the server (@andrinoff)
- 9eb90c9: fix(server): resolve relative unix --host before changing into --cwd (@andrinoff)
- 9ef4f2c: fix(server): respawn a dead server from the client reconnect loop (@andrinoff)
- ba10a00: fix(server): restore plan mode on workspace recovery (@andrinoff)
- 4bbe1fa: fix(server): restrict server socket and pipe to their owner (@andrinoff)
- 98395d1: fix(server): retry workspace creation over a fresh connection (@andrinoff)
- b8c53ab: fix(server): route question answers and cancels by batch id (@andrinoff)
- a8f3252: fix(server): run config command substitution in the workspace dir (#4171) (@andrinoff)
- 6bb53fd: fix(server): run the detached server from the per-host server dir (@andrinoff)
- 6bf4619: fix(server): serialize permission prompts per top-level session (@andrinoff)
- 48d74fe: fix(server): serialize stale socket recovery and bind across processes (@andrinoff)
- 97e8d18: fix(server): show version mismatch warnings on the client (@andrinoff)
- e952fa1: fix(server): skip unknown message part types from newer servers (@andrinoff)
- 1770bd4: fix(server): spawn the windows server with a hidden console (@andrinoff)
- bb9914d: fix(server): start stdio MCP servers in the workspace directory (@andrinoff)
- 2d3f1f1: fix(server): start windows server outside the client's job (@andrinoff)
- 9114879: fix(server): stop boundary walk at repo root spelled in another case (#4168) (@andrinoff)
- 69f401c: fix(server): stop crush run on SIGTERM and SIGHUP (@andrinoff)
- 096aa9c: fix(server): stop workspace teardown from closing other workspaces' MCP (@andrinoff)
- 9654903: fix(server): store file reads relative to the workspace dir (@andrinoff)
- ff2a581: fix(server): time out the version check on a hung server (@andrinoff)
- 81d6c2a: fix(server): wait for a slow-starting spawned server (@andrinoff)
- 6f2026c: fix(server): wait for in-flight workspace teardowns on shutdown (@andrinoff)
- ca19cdb: fix(server): wait for self-shutdown to finish before exiting (@andrinoff)
- fc17707: fix(sessions): keep the deleted slot in view instead of jumping to top (#3770) (@taciturnaxolotl)
- f15dff1: fix(ui): align plan card borders with screen cell widths (#4321) (@remote-controlled-man)
- 0f9de6a: fix(ui): keep a running tool's timer ticking until it replies (#4303) (@taciturnaxolotl)
- b6b6544: fix(ui): keep sysadmin mode out of the shift+tab cycle (@taciturnaxolotl)
- d05fb53: fix: preserve replayed message whitespaces (#4248) (@namore)
Other stuff
- e7e9955: chore: auto-update files (@charmcli)
- 7ef47d5: chore: update fantasy and catwalk (@andreynering)
- 42d8fb5: feat(ui/styles): make the mode banner fill themeable (#4326) (@sam0uly)
- fa0718a: job: fix hang with lingering children (#4328) (@meowgorithm)
- 6ea2a54: perf(ui): keep theme switches and overflow from re-rendering the transcript (#4304) (@taciturnaxolotl)
- b41cdfd: refactor(ui): drop the unused finished state from list items (#4308) (@taciturnaxolotl)
- eadc50d: refactor(ui): make every live timer tick together off one animation clock (@taciturnaxolotl)
- 4d4a99a: subagent-ui: differentiate description and timer colors in sidebar (@meowgorithm)
Verifying the artifacts
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.102.0/checksums.txt'
wget 'https://github.com/charmbracelet/crush/releases/download/v0.102.0/checksums.txt.sigstore.json'Then, verify it using cosign:
cosign verify-blob \
--certificate-identity-regexp '^https://github.com/charmbracelet/crush/\.github/workflows/(release|nightly)\.yml@' \
--certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
--bundle 'checksums.txt.sigstore.json' \
./checksums.txtIf the output is Verified OK, you can safely use it to verify the checksums of other artifacts you downloaded from the release using sha256sum:
sha256sum --ignore-missing -c checksums.txtDone! You artifacts are now verified!
Thoughts? Questions? We love hearing from you. Feel free to reach out on X, Discord, Slack, The Fediverse, Bluesky.