> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kylon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Kylon CLI on macOS or Linux.

## Requirements

* **Node.js 22** or newer (npm ships with Node)
* macOS or Linux (Windows users should use WSL)

## Install

The Kylon CLI is published to npm as [`kylon-cli`](https://www.npmjs.com/package/kylon-cli). Install it globally so the `kylon` binary is on your `PATH`:

```bash theme={null}
npm install -g kylon-cli@latest
```

Install it globally rather than running it through `npx`: the gateway daemon's agent subprocess calls `kylon workspace …`, which resolves `kylon` from `PATH`, so a persistent binary must be installed.

## Upgrade

Re-run the install command — npm reinstalls the newest published build.

## Verify

```bash theme={null}
kylon --version
```

## Install without sudo

If the global install fails with a permissions error, either run it with `sudo`:

```bash theme={null}
sudo npm install -g kylon-cli@latest
```

…or point npm's global prefix at a writable directory on your `PATH`:

```bash theme={null}
npm config set prefix "$HOME/.local"
npm install -g kylon-cli@latest
```

Then confirm that `$HOME/.local/bin` is on your `PATH`.