diff --git a/README.md b/README.md
index d708c4d..49f1d0b 100644
--- a/README.md
+++ b/README.md
@@ -112,6 +112,7 @@ To automate step 2, run `ddev claude-swap auto` in a spare terminal (or an
 `ddev claude-swap` forwards every argument straight to `cswap`, so any `cswap`
 subcommand works (`switch`, `run`, `map`, `disable`, `export`, `import`, `tui`, …).
 `ddev claude-swap upgrade` updates `claude-swap` to the latest release.
+`ddev cswap` is a shorter alias for `ddev claude-swap` (e.g. `ddev cswap list`).
 
 ### Starting a session pinned to an account
 
diff --git a/commands/web/claude-swap b/commands/web/claude-swap
index 462eaf7..86c6774 100755
--- a/commands/web/claude-swap
+++ b/commands/web/claude-swap
@@ -2,7 +2,8 @@
 #ddev-generated
 ## Description: Manage multiple Claude accounts (claude-swap / cswap)
 ## Usage: claude-swap [command]
-## Example: "ddev claude-swap list"
+## Example: "ddev claude-swap list" or "ddev cswap list"
+## Aliases: cswap
 set -euo pipefail
 
 INSTALL_SCRIPT="${DDEV_APPROOT}/.ddev/claude-code/install-swap.sh"