Repository navigation
Channels, custom prompts and server hardening
There's so much good stuff in this release and we're really proud of all of it. Read on for more.
BYO Prompts
At last, you can replace the system prompts with…whatever you want. And not just the main agent but prompts for subagents, planning, compaction, session titles and crush init:
option prompt coder ~/.config/crush/prompts/coder.md.tpl
option prompt summary prompts/summary.mdYou can set prompt in the global config, override per project in local config, or override the prompt with --prompt name=path.
For more on prompts, see the docs.
Riding in the Night
Crush now ships with a Knight Rider-inspired KITT theme courtesy @cdancy. Rosé Pine Classic, Moon and Dawn are now available, too.
Nerd out with Nerd Fonts
At last, nerd fonts! Support is detected automatically, so they'll never break your terminal, too! Crush now uses their icons, LSP status and Git included. Note that if you're running Crush over SSH you'll need to enable Nerd fonts option ui nerd-fonts true.
# Hate nerd fonts? You can turn 'em off, too.
option ui nerd-fonts falseChannels
Channels are an experimental MCP feature from Claude, now available in Crush thanks to the fine work of @joestump. In short, channels allow MCP servers to push events into your session as they happen.
crush --channels server:webhook --channels server:signalOr turn one on permanently in your crushrc:
# crushrc
mcp add webhook \
--type http \
--url https://example.com/mcp \
--channel trueCrush uses the same protocol as Claude Channels, so existing channel servers should just work™.
Server Hardening
Client-server mode is now now sturdier than ever. It's now more secure and has a ton of small improvements, correctness fixes, nad bugfixes, especially on Windows.
And So Much More
- 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.

