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

# Installation

> Install the mulerun CLI globally, per-project, or run it on demand

The CLI is published to npm as [`@mulerunai/cli`](https://www.npmjs.com/package/@mulerunai/cli).
It bundles the right native binary for your platform automatically (macOS
arm64/x64, Linux arm64/x64). Node.js 20+ is required.

## Global install

The recommended setup. The `mulerun` binary becomes available everywhere on
your `PATH`.

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @mulerunai/cli
  ```

  ```bash bun theme={null}
  bun add -g @mulerunai/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @mulerunai/cli
  ```

  ```bash yarn theme={null}
  yarn global add @mulerunai/cli
  ```
</CodeGroup>

Verify the install:

```bash theme={null}
mulerun --version
mulerun --help
```

## Run on demand

For one-off use, run through `npx` or `bunx` without installing:

```bash theme={null}
npx -y @mulerunai/cli --version
npx -y @mulerunai/cli login
bunx @mulerunai/cli computer list
```

The package is cached locally; subsequent invocations reuse the same install.

## Per-project install

If you want the version pinned to a single repository (recommended for CI):

```bash theme={null}
npm install --save-dev @mulerunai/cli
```

Then call it through your package runner:

```bash theme={null}
npx mulerun computer list
```

## Upgrading

The CLI can upgrade itself in place:

```bash theme={null}
mulerun upgrade           # install latest
mulerun upgrade --check   # only print current vs latest
```

It will also auto-upgrade in the background on routine commands unless you
opt out:

```bash theme={null}
export MULERUN_NO_AUTO_UPGRADE=1
```

See the [`upgrade`](/cli/commands/upgrade) command page for full details.

## Uninstall

```bash theme={null}
npm uninstall -g @mulerunai/cli
# or
bun remove -g @mulerunai/cli
```

## Next step

Head to [Configuration](/cli/configuration) to set your token and any
optional proxy or base URL.