v0.18.0

charmbracelet/crushv0.18.0Nov 13, 2025by github-actions[bot]

AI Summary

This release changes the default documentation file from CRUSH.md to AGENTS.md to follow the agents.md convention, with a new configuration option to customize the filename. It also includes a bug fix for test attribution to avoid system prompt mismatch.

Key Highlights

Default documentation file changed from CRUSH.md to AGENTS.md to follow the agents.md convention
New configuration setting allows customizing the default filename
Backward compatible - still reads CRUSH.md if it exists
Bug fix for test attribution to avoid system prompt mismatch

New Features

Default to creating AGENTS.md on new projects instead of CRUSH.md
New config setting to customize the default documentation filename

Full Release Notes

# Alright, alright: AGENTS.md

Crush will now default to creating an `AGENTS.md` by default on new projects, instead of the `CRUSH.md` you know and love. This all in effort of standards and is another step to more closely following [that convention](https://agents.md/). If your project still has a `CRUSH.md` file, don't worry. We'll still read that if available.

Like things the old way? Want to use a different filename altogether? Cool: [you can customize the behavior](https://github.com/charmbracelet/crush?tab=readme-ov-file#initialization).

This is, of course, another feature from our hot contributor friend, @Amolith.

Thanks, and see you in the next release! 💘

## Changelog
### New!
* 4e40b4714644fd1bcb03fc3f0a74ca037f2189a5: feat(config): default to AGENTS.md w/ new setting (#1403) (@Amolith)
### Fixed
* c094eaf6c73a02e1972ce1d323175b92d4315d5e: fix(test): set a fixed attribution to avoid system prompt mismatch (@andreynering)

---

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

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

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

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' \
  --cert 'https://github.com/charmbracelet/crush/releases/download/v0.18.0/checksums.txt.pem' \
  --signature 'https://github.com/charmbracelet/crush/releases/download/v0.18.0/checksums.txt.sig' \
  ./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).