diff --git a/.llms-snapshots/llms-full.txt b/.llms-snapshots/llms-full.txt
index 7616ff5f..33cc84ed 100644
--- a/.llms-snapshots/llms-full.txt
+++ b/.llms-snapshots/llms-full.txt
@@ -7912,6 +7912,10 @@ juno login --mode developmentjuno deploy --mode staging
 
 The value for `--mode` can be any string. If omitted, it defaults to production.
 
+**Important:**
+
+The `development` value is reserved. When you use `--mode development`, the tooling automatically understands that you are working with the local emulator.
+
 ---
 
 ### Profile
diff --git a/docs/reference/cli.mdx b/docs/reference/cli.mdx
index 681938f1..ee2addb9 100644
--- a/docs/reference/cli.mdx
+++ b/docs/reference/cli.mdx
@@ -321,6 +321,12 @@ juno deploy --mode staging
 
 The value for `--mode` can be any string. If omitted, it defaults to production.
 
+:::important
+
+The `development` value is reserved. When you use `--mode development`, the tooling automatically understands that you are working with the local emulator.
+
+:::
+
 ---
 
 ### Profile