From c3bbcf5bc18b810b9d7b848bc066c671c8f8f2fe Mon Sep 17 00:00:00 2001
From: Evan Sosenko <evan@getseam.com>
Date: Thu, 6 Aug 2026 15:04:30 -0700
Subject: [PATCH 1/2] Install via homebrew cask

---
 README.md | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 756dafc2..41063ad5 100644
--- a/README.md
+++ b/README.md
@@ -15,24 +15,39 @@ prompted for, with suggestions pulled from your workspace. Pass
 
 ## Installation
 
+### npm
+
 Install the CLI globally using [npm] with
 
 ```
 $ npm install --global @seamapi/cli
 ```
 
-Alternatively, download a standalone binary for your platform from the
-[latest GitHub release]. The macOS binaries are signed with the Seam Labs, Inc.
-Apple Developer ID and notarized by Apple, so macOS runs them without
-a Gatekeeper prompt.
+### Homebrew
+
+Install the CLI from [Homebrew] with
+
+```
+$ brew install --cask seam
+```
+
+### Standalone binary
+
+Download a standalone binary for your platform from the [latest GitHub
+release]. The macOS binaries are signed with the Seam Labs, Inc. Apple
+Developer ID and notarized by Apple, so macOS runs them without a Gatekeeper
+prompt.
+
+### Arch Linux
 
-On Arch Linux, install the [`seam-bin`][aur] package from the AUR with
+Install the [`seam-bin`][aur] package from the AUR with
 
 ```
 $ paru -S seam-bin
 ```
 
 [aur]: https://aur.archlinux.org/packages/seam-bin
+[Homebrew]: https://formulae.brew.sh/cask/seam
 [latest GitHub release]: https://github.com/seamapi/cli/releases/latest
 [npm]: https://www.npmjs.com/
 [Seam Wizard]: https://github.com/seamapi/wizard

From a84bc38107d7f41888f42fbc3b419fefd915745b Mon Sep 17 00:00:00 2001
From: Evan Sosenko <evan@getseam.com>
Date: Tue, 18 Aug 2026 16:24:08 -0700
Subject: [PATCH 2/2] Revise Seam CLI installation instructions

Updated installation instructions for Seam CLI, including Zsh setup, npm, Homebrew, standalone binary, and Arch Linux installation methods.
---
 README.md | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 41063ad5..f7cab552 100644
--- a/README.md
+++ b/README.md
@@ -15,12 +15,20 @@ prompted for, with suggestions pulled from your workspace. Pass
 
 ## Installation
 
+If you use Zsh, the completions only work if you enable compinit in your .zshrc with
+
+```sh
+autoload -Uz compinit
+compinit
+```
+
 ### npm
 
 Install the CLI globally using [npm] with
 
 ```
 $ npm install --global @seamapi/cli
+$ seam completion --install
 ```
 
 ### Homebrew
@@ -28,7 +36,14 @@ $ npm install --global @seamapi/cli
 Install the CLI from [Homebrew] with
 
 ```
-$ brew install --cask seam
+$ brew install --cask seamapi/tap/seam-cli
+```
+
+The Seam CLI may also be installed from Homebrew Core,
+but it does not include the Seam Wizard.
+
+```
+$ brew install seam
 ```
 
 ### Standalone binary
@@ -38,12 +53,20 @@ release]. The macOS binaries are signed with the Seam Labs, Inc. Apple
 Developer ID and notarized by Apple, so macOS runs them without a Gatekeeper
 prompt.
 
+Then install the shell completions with
+
+```
+$ seam completion --install
+```
+
 ### Arch Linux
 
 Install the [`seam-bin`][aur] package from the AUR with
 
 ```
-$ paru -S seam-bin
+$ git clone https://aur.archlinux.org/seam-bin.git
+$ cd seam-bin
+$ makepkg -si
 ```
 
 [aur]: https://aur.archlinux.org/packages/seam-bin