jdx · jdx · Sep 21, 2026 · Sep 21, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,28 @@
 # Changelog
 
+## [6.11.0](https://github.com/jdx/usage/compare/v6.10.0..v6.11.0) - 2026-09-21
+
+### 🚀 Features
+
+- **(parse)** select default subcommands on empty invocations by [@zeitlinger](https://github.com/zeitlinger) in [#1458](https://github.com/jdx/usage/pull/1458)
+- **(spec)** put a CLI's logo on its help page by [@jdx](https://github.com/jdx) in [#1455](https://github.com/jdx/usage/pull/1455)
+
+### 🐛 Bug Fixes
+
+- **(cli)** lay help out at the terminal's width, colour a self-dispatched page, and space examples apart by [@jdx](https://github.com/jdx) in [#1454](https://github.com/jdx/usage/pull/1454)
+
+### 🔍 Other Changes
+
+- stop compiling cargo-edit and installing unused tools in CI by [@jdx](https://github.com/jdx) in [#1451](https://github.com/jdx/usage/pull/1451)
+- drop OpenSSL build deps from the Cloud Agent image and fix its libicu package by [@jdx](https://github.com/jdx) in [#1452](https://github.com/jdx/usage/pull/1452)
+- re-pin renovate-config reusable workflows to current main by [@jdx](https://github.com/jdx) in [f7a6aeb](https://github.com/jdx/usage/commit/f7a6aebcee06ea6fb4404dd19d255b1a77282df3)
+
+### 📦️ Dependency Updates
+
+- bump mr-boxington to 1.14.0 and drop the mbx fallback docs by [@jdx](https://github.com/jdx) in [#1449](https://github.com/jdx/usage/pull/1449)
+- drop the stale aube macos-x64 row from mise.lock by [@jdx](https://github.com/jdx) in [#1453](https://github.com/jdx/usage/pull/1453)
+- lock file maintenance by [@renovate[bot]](https://github.com/renovate[bot]) in [#1457](https://github.com/jdx/usage/pull/1457)
+
 ## [6.10.0](https://github.com/jdx/usage/compare/v6.9.1..v6.10.0) - 2026-09-19
 
 ### 🚀 Features

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -42,20 +42,20 @@ license = "MIT"
 [workspace.dependencies]
 clap_usage = { path = "./clap_usage", version = "5.0.0" }
 usage-cli = { path = "./cli" }
-usage-argv = { path = "./argv", version = "6.10.0", default-features = false }
-usage-config = { path = "./config", version = "6.10.0" }
-usage-derive = { path = "./derive", version = "6.10.0" }
+usage-argv = { path = "./argv", version = "6.11.0", default-features = false }
+usage-config = { path = "./config", version = "6.11.0" }
+usage-derive = { path = "./derive", version = "6.11.0" }
 # No features, and defaults off. A feature named here is inherited by every member that writes
 # `workspace = true` and inlines into their published manifests — so `clap` and `validation`
 # reached members that use neither, one of them an adopter's build script. Defaults
 # are off rather than absent because cargo *ignores* a member's `default-features = false` unless
 # the workspace declaration sets it too, and warns that it may become a hard error. Members name
 # what they need, `docs` included.
-usage-lib = { path = "./lib", version = "6.10.0", default-features = false }
-usage-rs = { path = "./usage-rs", version = "6.10.0" }
-usage-dynamic = { path = "./usage-dynamic", version = "6.10.0" }
-usage-test = { path = "./test", version = "6.10.0" }
-usage-validation = { path = "./validation", version = "6.10.0" }
+usage-lib = { path = "./lib", version = "6.11.0", default-features = false }
+usage-rs = { path = "./usage-rs", version = "6.11.0" }
+usage-dynamic = { path = "./usage-dynamic", version = "6.11.0" }
+usage-test = { path = "./test", version = "6.11.0" }
+usage-validation = { path = "./validation", version = "6.11.0" }
 
 [workspace.metadata.release]
 allow-branch = ["main"]
diff --git a/argv/Cargo.toml b/argv/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-argv"
 description = "Zero-allocation argv parser for usage specs"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

diff --git a/cli/Cargo.toml b/cli/Cargo.toml
@@ -2,7 +2,7 @@
 name = "usage-cli"
 edition = "2021"
 rust-version = "1.91"
-version = "6.10.0"
+version = "6.11.0"
 description = "CLI for working with usage-based CLIs"
 license = { workspace = true }
 authors = { workspace = true }

diff --git a/cli/usage.usage.kdl b/cli/usage.usage.kdl
@@ -2,7 +2,7 @@
 min_usage_version "6.5"
 name usage
 bin usage
-version "6.10.0"
+version "6.11.0"
 repository "https://github.com/jdx/usage"
 source_code_link_template #"""
 {%- set path = path | replace(from='-', to='_') -%}

diff --git a/config/Cargo.toml b/config/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-config"
 description = "Layered configuration resolution for usage specs, with provenance"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

diff --git a/derive/Cargo.toml b/derive/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-derive"
 description = "Derive macro that compiles a CLI definition into parse tables and a usage spec"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

diff --git a/docs/cli/reference/commands.json b/docs/cli/reference/commands.json
@@ -2071,7 +2071,7 @@
     "sources": {},
     "files": []
   },
-  "version": "6.10.0",
+  "version": "6.11.0",
   "usage": "Usage: usage <COMMAND>\n       usage --completions <COMPLETIONS>\n       usage --usage-spec",
   "complete": {},
   "source_code_link_template": "{%- set path = path | replace(from='-', to='_') -%}\n{%- if cmd.subcommands | length > 0 -%}\n{%- set path = path ~ \"/mod.rs\" -%}\n{%- elif path in [\"bash\", \"fish\", \"powershell\", \"zsh\"] -%}\n{%- set path = \"shell.rs\" -%}\n{%- else -%}\n{%- set path = path ~ \".rs\" -%}\n{%- endif -%}\nhttps://github.com/jdx/usage/blob/main/cli/src/cli/{{path}}",

diff --git a/docs/cli/reference/index.md b/docs/cli/reference/index.md
@@ -2,7 +2,7 @@
 
 # `usage`
 
-**Version:** 6.10.0
+**Version:** 6.11.0
 
 **Repository:** https://github.com/jdx/usage
 

diff --git a/lib/Cargo.toml b/lib/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-lib"
 edition = "2021"
-version = "6.10.0"
+version = "6.11.0"
 rust-version = "1.91"
 include = [
     "/Cargo.toml",

diff --git a/test/Cargo.toml b/test/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-test"
 description = "Test helpers for CLIs built with usage"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

diff --git a/usage-dynamic/Cargo.toml b/usage-dynamic/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-dynamic"
 description = "Runtime command catalogs for usage-rs applications"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }
@@ -12,7 +12,7 @@ license = { workspace = true }
 
 [dependencies]
 usage-argv = { workspace = true, features = ["help-advanced", "spec", "complete"] }
-usage-parser = { package = "usage-lib", path = "../lib", version = "6.10.0", default-features = false, features = ["cli-help"] }
+usage-parser = { package = "usage-lib", path = "../lib", version = "6.11.0", default-features = false, features = ["cli-help"] }
 
 [package.metadata.release]
 shared-version = true

diff --git a/usage-rs/Cargo.toml b/usage-rs/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-rs"
 description = "A compiled CLI parser for Rust, built on usage specs"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }

diff --git a/usage-rs/tests/fixtures/runtime-identity/Cargo.lock b/usage-rs/tests/fixtures/runtime-identity/Cargo.lock
diff --git a/validation/Cargo.toml b/validation/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "usage-validation"
 description = "Portable expression validation for usage specs"
-version = "6.10.0"
+version = "6.11.0"
 edition = "2021"
 rust-version = "1.91"
 homepage = { workspace = true }