v0.52.0

charmbracelet/crushv0.52.0Mar 25, 2026by github-actions[bot]

AI Summary

This release introduces project-based skills support, allowing teams to share skills by committing them to `.agents/skills`, `.crush/skills`, `.claude/skills`, or `.cursor/skills` directories. It also adds environment variables (`CRUSH`, `AGENT`, `AI_AGENT`) for apps to detect when they're running via Crush, improves file picker sorting, and ensures the model responds in the user's prompt language.

Key Highlights

Project skills: Added support for local skills in repository directories (`.crush/skills`, `.agents/skills`, `.claude/skills`, `.cursor/skills`)
Environment variables: Apps can now detect Crush via `CRUSH=1`, `AGENT=crush`, and `AI_AGENT=crush`
Non-English prompts: Model now responds in the user's prompt language
Windows skills: Global skills can now be placed in `~/.config/crush/skills`
File picker: Significantly improved completion ranking algorithm for better UX

New Features

Project-based skills support for team collaboration
Environment variables for Crush detection (`CRUSH`, `AGENT`, `AI_AGENT`)
Language-aware responses that match the user's prompt language
Enhanced file completion ranking with filename-based prioritization
Windows configuration path improvements for global skills

Full Release Notes

# Project skills + more

Hey! It's Wednesday already (time flies), and we're here bringing you a few good nice enhancements. Stay with us!

## Project skills

We just added support for local skills. This means that you can easily share skills with your team mates or contributors inside the repository by just committing them.

Crush will look for the following projects paths:

* `.agents/skills`
* `.crush/skills`
* `.claude/skills`
* `.cursor/skills`

Another related enhancement is that Windows users will also be able to put global skills on `~/.config/crush/skills` or `~/.config/agents/skills`, which is a little bit easier to manage to having them on `~\AppData\Local\crush\skills\`.

[Check out the complete docs here](https://github.com/charmbracelet/crush?tab=readme-ov-file#agent-skills).

## Non-English prompts

We improved our system prompts to enforce that the model should respond to message and generate session titles according to _your_ prompt language. For example, if you're talking to the model in Portuguese 🇵🇹 🇧🇷, you'll want it to respond in Portuguese.

## Better file picker order

You know that you can easily pick files fro the text area by typing `@`, right? @huaiyuWangh made a great contribution on significantly improving the sorting based on your filter. This is a very signiifcant UX improvement for bug repos.

Talking about @huaiyuWangh, he also fixed the "Open file picker" option in the command pallette (<kbd>ctrl+p</kbd>).

## Allow apps to detect Crush

Starting on this release, Crush will set these ENVs when running Bash commands via the Bash tool. The intention is to allow programs to detect that they are being ran by Crush.

* `CRUSH=1`
* `AGENT=crush`
* `AI_AGENT=crush`

The `AGENT` and `AI_AGENT` ENVs are _kinda_ a unofficial new standard, so a few tools already look for them.

That's all for today.
Enjoy the release and keep Crushing!
The Charm Team ✨ 

## Changelog
### New!
* 0f5df9bec255742fa46046ce2993399cdc5ebe67: feat(bash): set `CRUSH=1`, `AGENT=crush` and `AI_AGENT=crush` (#2484) (@andreynering)
* 0fcf79baf4aebd2b87cb49a8a287a18e6ad1dcac: feat(ui): improve file completion ranking algorithm (@huaiyuWangh)
* f67fa357932387ab20dada0ea1ac416da021143a: feat(ui): prioritize filename-based completion ranking (@huaiyuWangh)
* cd5c937d2e265a1defbb45b953592286787f2346: feat: load project skills automatically from `.crush/skills` and more (@andreynering)
### Fixed
* d89120c5309359561c267b76e36918fab0ff6b1f: fix(hyper): ensure it's possible to override with `HYPER_URL` (@andreynering)
* ffc7a9d261421de4031b386da030b696e88aa95d: fix(log): don't conflate body drain errors with HTTP errors (@meowgorithm)
* 697fad9548abd5bf9f842896469de6119e7b401d: fix: complete file picker dialog action (#2483) (@huaiyuWangh)
* db043c375866dcf9246e8bdb36677439168de482: fix: on windows, also load skills from `$HOME/.config/crush/skills` (@andreynering)
* 06cf63fa9d929aac71eaa66f4612681c21ca4f9f: fix: session titles should keep the same spoken language (@andreynering)
### Docs
* 0e3d47273fe9a8bc749a6e928b8e7d9f102c1956: docs(readme): update skill docs with updates and new paths (@andreynering)
* 09da90a2a6b9c7b0a498304f1fb924a3012e750b: docs(ui): add comprehensive comments to completion ranking algorithm (@huaiyuWangh)
### Other stuff
* 6920cf1174e9f33b82e5f4a2ac2f93eba6b6ce1c: chore(lint): modernize interfaces in the db package (@meowgorithm)
* 1a0b6389f0624d5696235bb6343c7a7837ed8da3: chore: update generated `.crush/.gitignore` to not ignore skills (@andreynering)
* 2325de7aca97f98dafdda5832db4637328788210: fix(system-prompt): tell the model to respond in the prompt spoken language (@andreynering)

---

<details>
<summary>Verifying the artifacts</summary>

First, download the [`checksums.txt` file](https://github.com/charmbracelet/crush/releases/download/v0.52.0/checksums.txt) and the [`checksums.txt.sigstore.json` file](https://github.com/charmbracelet/crush/releases/download/v0.52.0/checksums.txt.sigstore.json) files, for example, with `wget`:

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

Then, verify it using [`cosign`](https://github.com/sigstore/cosign):

```bash
cosign verify-blob \
  --certificate-identity 'https://github.com/charmbracelet/meta/.github/workflows/goreleaser.yml@refs/heads/main' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --bundle 'checksums.txt.sigstore.json' \
  ./checksums.txt
```

If the output is `Verified OK`, you can safely use it to verify the checksums of other artifacts you downloaded from the release using `sha256sum`:

```bash
sha256sum --ignore-missing -c checksums.txt
```

Done! You artifacts are now verified!

</details>

<a href="https://charm.land/"><img alt="The Charm logo" src="https://stuff.charm.sh/charm-banner-next.jpg" width="400"></a>

Thoughts? Questions? We love hearing from you. Feel free to reach out on [X](https://x.com/charmcli), [Discord](https://charm.land/discord), [Slack](https://charm.land/slack), [The Fediverse](https://mastodon.social/@charmcli), [Bluesky](https://bsky.app/profile/charm.land).