---
title: CLI Installation
description: Install the Capawesome Cloud CLI — run it with npx or install it globally, pin a version for CI, and keep it up to date.
---

# Installation

The Capawesome Cloud CLI is distributed as the [`@capawesome/cli`](https://www.npmjs.com/package/@capawesome/cli){:target="_blank"} npm package and runs on [Node.js](https://nodejs.org){:target="_blank"}. Any current LTS version of Node.js works, and npm comes bundled with it — so there's nothing else to install.

## Run with npx (recommended)

You don't need to install anything — `npx` downloads and runs the CLI on demand:

```bash
npx @capawesome/cli apps:list
```

This is the recommended approach for occasional use and for CI, because it doesn't rely on a global install being present.

## Install globally

If you reach for the CLI often, install it globally so it doesn't have to be fetched on each run:

```bash
npm install -g @capawesome/cli
```

You still invoke it the same way — `npx @capawesome/cli …` — but npx now uses the globally installed copy instead of downloading it every time.

## Pin a version for CI

In CI/CD, pin the version so pipelines are reproducible and upgrades happen on purpose rather than silently with each run:

```bash
npx @capawesome/cli@4.9.3 apps:builds:create
```

## Update

Update a global install to the latest version with:

```bash
npm install -g @capawesome/cli@latest
```

## Next steps

- [Authentication](authentication.md) — log in or set up a token before your first command.
- [Usage](usage.md) — command anatomy, global flags, and JSON output.