diff -r aaf24c4e07c5 -r bea3fb9b867f README.md
--- a/README.md	Wed Jul 15 16:05:07 2026 -0500
+++ b/README.md	Wed Jul 15 16:07:25 2026 -0500
@@ -83,6 +83,7 @@
 | `shell <name> [--cwd <path>]` | Open a bash login shell inside the project's container, in the repo's directory by default. |
 | `sync [name] [--no-delete] [--dry-run]` | Mirror local repos to NFS backup via rsync. NFS auto-mount aware. |
 | `remove <name> [--yes | -y] [--keep-incus]` | Delete the incus container and registry entry. Prompts for confirmation unless `--yes`. The source repo on host is **never** deleted. |
+| `rename <old> <new> [--yes | -y] [--migrate-claude-history]` | Rename a project across its incus container, registry entry, and — when the repo dirname is coupled to the name — the host repo directory and `repo` bind device. Idempotent (safe to re-run after a partial rename). `--migrate-claude-history` also moves the repo's Claude history directory. A project whose `repo` dirname is deliberately decoupled from its name has only its identity renamed; the repo directory is left untouched. |
 | `--help` / `-h` / `help` | Show usage and subcommand list. |
 | `--version` / `-V` | Print version string. |