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

# Install the Capy CLI

> Install the Capy CLI with npm, with the standalone installer (no Node needed), or on Windows with PowerShell.

Capy is one CLI. Pick the install that fits your machine.

## npm

```bash theme={null}
npm install -g @capysc/cli
```

Or with Bun:

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

The npm package needs Node.js 18 or newer.

On Windows, npm installs two launchers: `capy.ps1` and `capy.cmd`. If PowerShell refuses to run `capy` because running scripts is disabled on the machine, run `capy.cmd` instead. The PowerShell installer below installs `capy.exe`, which has no launcher script.

## Standalone installer (macOS and Linux)

No Node or npm needed.

```bash theme={null}
curl -fsSL https://capy.sc/install.sh | sh
```

The installer downloads the binary for your system from GitHub Releases and checks its SHA-256 before installing. It supports macOS and Linux on arm64 and x64. It needs `curl` or `wget`, `tar`, and `sha256sum` or `shasum`.

If Capy is already installed as a standalone file, the installer replaces it in place. If Capy came from npm, the installer stops and nothing is changed: update with `npm install -g @capysc/cli`.

For a new install it uses `/usr/local/bin` when that folder is on your `PATH` and writable, otherwise `~/.local/bin`. `CAPY_INSTALL_DIR` sets the folder.

## Windows PowerShell

Use the native PowerShell installer, not `install.sh`. It supports x64 only.

```powershell theme={null}
irm https://capy.sc/install.ps1 | iex
capy --version
```

Or download and run it using Windows' `curl.exe`:

```powershell theme={null}
$installer = curl.exe -fsSL https://capy.sc/install.ps1 | Out-String
if ($LASTEXITCODE -ne 0) { throw 'Installer download failed' }
Invoke-Expression $installer
capy --version
```

## Install a specific version

Use this in Dockerfiles and CI, so every build gets the same Capy. Each release publishes its own `install.sh` with that version's checksums. Run it from the release URL:

```bash theme={null}
curl -fsSL https://github.com/capysc/capy-cli/releases/download/v<version>/install.sh | sh
```

Or set `CAPY_VERSION` on the installer:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/capysc/capy-cli/main/install.sh | CAPY_VERSION=<version> sh
```

For npm, install the version by name: `npm install -g @capysc/cli@<version>`.

## Remove the standalone binary

Delete the `capy` file from the folder the installer printed. On Windows, delete `capy.exe` from that folder. The `~/.capy` folder holds your keys: do not delete it to reinstall.

## Next

> [card] [Get started](https://capy.sc/docs/getting-started/nodejs.md)
>
> Pick your runtime and sync your first secrets.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.