diff --git a/docs/.rules b/docs/.rules
index a7dbf1662c8..865980e1d93 100644
--- a/docs/.rules
+++ b/docs/.rules
@@ -61,12 +61,12 @@ For reference content:
 Use `sh` code blocks for terminal commands, not plain backticks:
 
 ```sh
-brew install zed-editor/zed/zed
+brew install --cask zed
 ```
 
 Not:
 ```
-brew install zed-editor/zed/zed
+brew install --cask zed
 ```
 
 For single inline commands in prose, backticks are fine: `zed .`
diff --git a/docs/src/migrate/vs-code.md b/docs/src/migrate/vs-code.md
index 5bc8db48a2f..e3f14bd6cd1 100644
--- a/docs/src/migrate/vs-code.md
+++ b/docs/src/migrate/vs-code.md
@@ -14,7 +14,7 @@ It covers which settings import automatically, which shortcuts map cleanly, and
 Zed is available on macOS, Windows, and Linux.
 
 For macOS, you can download it from zed.dev/download, or install via Homebrew:
-`brew install zed-editor/zed/zed`
+`brew install --cask zed`
 
 For most Linux users, the easiest way to install Zed is through our installation script:
 `curl -f https://zed.dev/install.sh | sh`