diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..1d9d1bc
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,83 @@
+# Changelog
+
+## [5.0.4] - 2026-11-09
+
+- Many fixes for `swup validate`. Make the advertised commands actually do what's advertised:
+  - Implement `--sitemap` (also supports absolute sitemap paths)
+  - Fail on an empty sitemap or a non-OK sitemap response
+  - Fix `--crawl` (migrate to crawler v2 API)
+  - Fix `--animation` and `--parallel` flags being ignored
+  - Fix animation duration checks not waiting long enough
+  - Pass transition-styles check if any expected style changes
+  - Mark failed pages as failed in the task list 😅
+
+## [5.0.3] - 2024-03-25
+
+- Optimize `swup package:format` and `swup package:lint` for usage in `lint-staged`
+
+## [5.0.2] - 2023-10-02
+
+- Fix command links in readme
+
+## [5.0.1] - 2023-09-26
+
+- Make TypeScript 5 available to plugins
+
+## [5.0.0] - 2023-09-19
+
+- Add `build` and `lint` commands for bundling packages
+- Simplify `validate` command args (possibly breaking change)
+- Use interactive listers for multi-step commands
+- Update CLI framework and tooling
+- Switch to TypeScript and ESM modules
+- Load config file from multiple locations
+
+## [4.0.3] - 2022-06-01
+
+- Fix error on non-TTY terminals
+
+## [4.0.2] - 2020-06-29
+
+- Support `asynchronous`, `baseUrl`, `runTests` and `testUrl` options in project config
+- Rename option `findUrls` to `baseUrl`
+- Rename shortcuts to `-t` (`runTests`) and `-u` (`testUrl`)
+- Fix log level
+
+## [4.0.1] - 2020-06-28
+
+- Run async tests sequentially
+
+## [4.0.0] - 2020-06-28
+
+- Run tests asynchronously
+- Make all options available from the CLI, with default values
+- Support relative URLs
+- Remove the `against` option
+- Rename option `swupOptions` to `swup`
+
+## [0.3.4] - 2020-06-28
+
+- Add option to crawl the website before validating
+
+## [0.3.3] - 2020-06-28
+
+- Add option to run tests for a single URL
+- Add option to run only one of the test cases
+- Improve validation logging
+
+## [0.3.2] - 2020-06-28
+
+- Initial release
+
+[5.0.4]: https://github.com/swup/cli/releases/tag/5.0.4
+[5.0.3]: https://github.com/swup/cli/releases/tag/5.0.3
+[5.0.2]: https://github.com/swup/cli/releases/tag/5.0.2
+[5.0.1]: https://github.com/swup/cli/releases/tag/5.0.1
+[5.0.0]: https://github.com/swup/cli/releases/tag/5.0.0
+[4.0.3]: https://github.com/swup/cli/releases/tag/4.0.3
+[4.0.2]: https://github.com/swup/cli/releases/tag/4.0.2
+[4.0.1]: https://github.com/swup/cli/releases/tag/4.0.1
+[4.0.0]: https://github.com/swup/cli/releases/tag/4.0.0
+[0.3.4]: https://github.com/swup/cli/releases/tag/0.3.4
+[0.3.3]: https://github.com/swup/cli/releases/tag/0.3.3
+[0.3.2]: https://github.com/swup/cli/releases/tag/0.3.2
diff --git a/README.md b/README.md
index 69c6380..a92367b 100644
--- a/README.md
+++ b/README.md
@@ -89,7 +89,7 @@ FLAG DESCRIPTIONS
     Choose the type of project to create: plugin or theme. Not required if name ends with "Plugin" or "Theme".
 ```
 
-_See code: [src/commands/create.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/create.ts)_
 
 ## `swup help [COMMANDS]`
 
@@ -136,7 +136,7 @@ FLAG DESCRIPTIONS
     Check for required package.json fields before bundling. Disable using --no-check.
 ```
 
-_See code: [src/commands/package/build.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/package/build.ts)_
+_See code: [src/commands/package/build.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/package/build.ts)_
 
 ## `swup package:check`
 
@@ -155,7 +155,7 @@ EXAMPLES
   $ swup package:check
 ```
 
-_See code: [src/commands/package/check.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/package/check.ts)_
+_See code: [src/commands/package/check.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/package/check.ts)_
 
 ## `swup package:dev`
 
@@ -182,7 +182,7 @@ FLAG DESCRIPTIONS
     Check for required package.json fields before bundling. Disable using --no-check.
 ```
 
-_See code: [src/commands/package/dev.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/package/dev.ts)_
+_See code: [src/commands/package/dev.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/package/dev.ts)_
 
 ## `swup package:format`
 
@@ -201,7 +201,7 @@ EXAMPLES
   $ swup package:format
 ```
 
-_See code: [src/commands/package/format.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/package/format.ts)_
+_See code: [src/commands/package/format.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/package/format.ts)_
 
 ## `swup package:lint`
 
@@ -220,7 +220,7 @@ EXAMPLES
   $ swup package:lint
 ```
 
-_See code: [src/commands/package/lint.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/package/lint.ts)_
+_See code: [src/commands/package/lint.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/package/lint.ts)_
 
 ## `swup validate`
 
@@ -298,5 +298,5 @@ FLAG DESCRIPTIONS
     CSS properties expected to change during animations, separated by comma.
 ```
 
-_See code: [src/commands/validate.ts](https://github.com/swup/cli/blob/5.0.3/src/commands/validate.ts)_
+_See code: [src/commands/validate.ts](https://github.com/swup/cli/blob/5.0.4/src/commands/validate.ts)_
 <!-- commandsstop -->
diff --git a/package-lock.json b/package-lock.json
index 41fcbb9..c235f1c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@swup/cli",
-  "version": "5.0.3",
+  "version": "5.0.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@swup/cli",
-      "version": "5.0.3",
+      "version": "5.0.4",
       "license": "MIT",
       "dependencies": {
         "@oclif/core": "^3.0.0-beta.13",
diff --git a/package.json b/package.json
index ef14dd3..ec3c201 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@swup/cli",
-  "version": "5.0.3",
+  "version": "5.0.4",
   "description": "Swup CLI for plugin development and site validation",
   "type": "module",
   "author": {