docs: update installation instructions to prioritize github releases

Author: jpoehnelt-bot

.changeset/docs-github-releases-install.md

@@ -0,0 +1,5 @@
+---
+"@googleworkspace/cli": patch
+---
+
+Update installation instructions to prioritize GitHub Releases over npm

README.md

@@ -14,9 +14,7 @@ Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JS
 </p>
 <br>
 
-```bash
-npm install -g @googleworkspace/cli
-```
+⬇️ **[Download the latest release for your OS](https://github.com/googleworkspace/cli/releases)**
 
 `gws` doesn't ship a static list of commands. It reads Google's own [Discovery Service](https://developers.google.com/discovery) at runtime and builds its entire command surface dynamically. When Google Workspace adds an API endpoint or method, `gws` picks it up automatically.
 
@@ -46,15 +44,14 @@ npm install -g @googleworkspace/cli
 
 ## Installation
 
+The recommended way to install `gws` is to download the pre-built binary for your OS and architecture from the **[GitHub Releases](https://github.com/googleworkspace/cli/releases)** page. Extract the archive and place the `gws` binary in your `$PATH`.
+
+For convenience, you can also use `npm` to automate downloading the appropriate binary from GitHub Releases:
+
 ```bash
 npm install -g @googleworkspace/cli
 ```
 
-> The npm package bundles pre-built native binaries for your OS and architecture.
-> No Rust toolchain required.
-
-Pre-built binaries are also available on the [GitHub Releases](https://github.com/googleworkspace/cli/releases) page.
-
 Or build from source:
 
 ```bash

crates/google-workspace-cli/README.md

@@ -6,14 +6,16 @@
 
 ## Install
 
+Download the pre-built binary for your OS and architecture from the **[GitHub Releases](https://github.com/googleworkspace/cli/releases)** page.
+
+Alternatively, you can use package managers as a convenience layer:
+
 ```bash
-npm install -g @googleworkspace/cli    # npm
+npm install -g @googleworkspace/cli    # npm (downloads GitHub release binary)
 cargo install google-workspace-cli     # crates.io
 nix run github:googleworkspace/cli     # nix
 ```
 
-Pre-built binaries are available on the [GitHub Releases](https://github.com/googleworkspace/cli/releases) page.
-
 ## Quick Start
 
 ```bash