Documention updates:

- npx is not supported
- package @kosli/cli should be used to install

Author: jbrejner

docs.kosli.com/content/getting_started/install.md

@@ -96,6 +96,9 @@ You can install Kosli CLI system-wide with `npm` from the default registry <http
 npm install -g @kosli/cli
 ```
 
+Using `npx` is currently not supported
+
+
 {{< /tab >}}
 
 {{< tab "From source" >}}

npm/README.md

@@ -49,6 +49,8 @@ npm install -g @kosli/cli
 
 npm resolves the `optionalDependencies` declared in the wrapper's `package.json` and installs only the platform-specific package that matches the current OS and CPU architecture — all non-matching packages are silently skipped. The wrapper's `bin/kosli` JS shim then locates the binary inside the installed platform package and executes it.
 
+> **`npx` is not supported.** `npx @kosli/cli` does not install optional dependencies, so the platform binary is never fetched and the command fails. Always install the package before running it.
+
 ## The `bin/` directories are populated by goreleaser
 
 The platform package `bin/` directories are **not committed to git**. They are populated automatically during the release process by a post-build hook in [`.goreleaser.yml`](../.goreleaser.yml):

npm/cli-darwin-arm64/README.md

@@ -1 +1,11 @@
-This is the macOS ARM 64-bit binary for the Kosli CLI (Apple Silicon). See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-darwin-arm64
+
+This is the macOS ARM64 platform binary for the Kosli CLI (Apple Silicon). **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.

npm/cli-darwin-x64/README.md

@@ -1 +1,11 @@
-This is the macOS 64-bit binary for the Kosli CLI. See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-darwin-x64
+
+This is the macOS x64 platform binary for the Kosli CLI. **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.

npm/cli-linux-arm/README.md

@@ -1 +1,11 @@
-This is the Linux ARM 32-bit binary for the Kosli CLI. See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-linux-arm
+
+This is the Linux ARM 32-bit platform binary for the Kosli CLI. **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.

npm/cli-linux-arm64/README.md

@@ -1 +1,11 @@
-This is the Linux ARM 64-bit binary for the Kosli CLI. See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-linux-arm64
+
+This is the Linux ARM64 platform binary for the Kosli CLI. **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.

npm/cli-linux-x64/README.md

@@ -1 +1,11 @@
-This is the Linux 64-bit binary for the Kosli CLI. See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-linux-x64
+
+This is the Linux x64 platform binary for the Kosli CLI. **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.

npm/cli-win32-arm64/README.md

@@ -1 +1,11 @@
-This is the Windows ARM 64-bit binary for the Kosli CLI. See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-win32-arm64
+
+This is the Windows ARM64 platform binary for the Kosli CLI. **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.

npm/cli-win32-x64/README.md

@@ -1 +1,11 @@
-This is the Windows 64-bit binary for the Kosli CLI. See https://github.com/kosli-dev/cli for details.
+# @kosli/cli-win32-x64
+
+This is the Windows x64 platform binary for the Kosli CLI. **Do not install this package directly.**
+
+Install the main package instead, which selects the right binary for your platform automatically:
+
+```sh
+npm install -g @kosli/cli
+```
+
+See the [Kosli CLI repository](https://github.com/kosli-dev/cli) for documentation and source code.