diff --git a/REPL.md b/REPL.md
index 081cf18..50f592a 100644
--- a/REPL.md
+++ b/REPL.md
@@ -81,7 +81,8 @@ roles cannot be persisted to a file and saved.
 
 > **Renamed from `.prompt`:** this command used to be called `.prompt`. That name now invokes MCP server prompts
 > (see [`.prompt`](#prompt---invoke-an-mcp-server-prompt) below). If you have muscle memory or macros built around
-> `.prompt <text>`, update them to `.temp-role <text>`.
+> `.prompt <text>`, update them to `.temp-role <text>`. The CLI flag followed the same rename: use `--temp-role <text>`
+> (the old `--prompt` flag is unbound and rejected).
 
 ![prompt-role](./images/roles/prompt-role.gif)
 
diff --git a/Roles.md b/Roles.md
index a86f5f2..2d24876 100644
--- a/Roles.md
+++ b/Roles.md
@@ -260,6 +260,6 @@ for more examples.
 # Temporary Roles
 Coyote also enables you to create temporary roles that will be discarded once you're finished with them. This is done via
 the `.temp-role` REPL command (previously named `.prompt`; that name now invokes [MCP server prompts](REPL#prompt---invoke-an-mcp-server-prompt))
-or the `--prompt` CLI flag:
+or the `--temp-role` CLI flag (previously `--prompt`, which is now unbound):
 
 ![prompt role](./images/roles/prompt-role.gif)