docs: refresh the README install instructions

Point installs at get.flagsmith.com rather than a raw.githubusercontent.com
path, add the npm package, and open with what the CLI is for instead of calling
it a work in progress.

The pinned --version example is wrapped in release-please block markers so it
bumps with every release like the ones in install.sh and install.ps1. It needs
the block form rather than an inline annotation because the line sits inside a
fenced code block, where the comment would render as part of the snippet.

Author: khvn26

README.md

@@ -1,6 +1,6 @@
 # Flagsmith CLI
 
-The next-generation Flagsmith command-line interface (work in progress).
+The Flagsmith command-line interface helps you manage and roll out your feature flags without leaving your terminal.
 
 ## Install
 
@@ -11,28 +11,38 @@ brew install Flagsmith/tap/flagsmith
 Or:
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/Flagsmith/flagsmith-cli/main/install.sh | sh
+curl -fsSL https://get.flagsmith.com | sh
 ```
 
 Installs to `$HOME/.local/bin` and adds it to your `PATH`. Options:
 
+<!-- x-release-please-start-version -->
+
 ```sh
-curl -fsSL https://raw.githubusercontent.com/Flagsmith/flagsmith-cli/main/install.sh | sh -s -- --version v2.0.0 --bin-dir /usr/local/bin --no-modify-path
-curl -fsSL https://raw.githubusercontent.com/Flagsmith/flagsmith-cli/main/install.sh | sh -s -- --help
+curl -fsSL https://get.flagsmith.com | sh -s -- --version v2.0.0-beta.3 --bin-dir /usr/local/bin --no-modify-path
+curl -fsSL https://get.flagsmith.com | sh -s -- --help
 ```
 
+<!-- x-release-please-end -->
+
 `FLAGSMITH_CLI_VERSION`, `FLAGSMITH_INSTALL_DIR` and `FLAGSMITH_NO_MODIFY_PATH` do the same if exported first.
 
 To pin the installer itself, fetch it at a commit you trust: `raw.githubusercontent.com/Flagsmith/flagsmith-cli/<sha>/install.sh`.
 
-Alternatively, `go install github.com/Flagsmith/flagsmith-cli/v2@v2.0.0-beta.3` (installs as `flagsmith-cli`), or grab an archive from [Releases](https://github.com/Flagsmith/flagsmith-cli/releases). <!-- x-release-please-version -->
-
 On Windows:
 
 ```powershell
 irm https://raw.githubusercontent.com/Flagsmith/flagsmith-cli/main/install.ps1 | iex
 ```
 
+Using npm:
+
+```sh
+npm install -g @flagsmith/cli
+```
+
+Alternatively, `go install github.com/Flagsmith/flagsmith-cli/v2@v2.0.0-beta.3` (installs as `flagsmith-cli`), or grab an archive from [Releases](https://github.com/Flagsmith/flagsmith-cli/releases). <!-- x-release-please-version -->
+
 ## Build
 
 ```sh
@@ -56,7 +66,7 @@ flagsmith flag list    # list the flags in the current environment
 
 ## Commands
 
-Full reference for every command and flag: <https://flagsmith.github.io/flagsmith-cli/> (generated from `--help`, so it matches the release).
+Full reference for every command and flag: <https://flagsmith.github.io/flagsmith-cli/>.
 
 Reading works against any Flagsmith instance. Changing flags — `flag update`, `flag enable`/`disable`, `flag reorder`, `flag delete` — needs Flagsmith 2.263.0 or newer, self-hosted or SaaS.