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

# Instalação

> Como instalar e atualizar a CLI da Zapster.

## Pré-requisitos

* **Node.js 22 LTS+** (Node 18 e 20 já passaram do EOL ou estão prestes).
* **npm 10+** (vem com Node 22).

## Instalação global

```bash theme={null}
npm i -g @zapsterapi/cli
```

Confirme:

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

## Atualização

```bash theme={null}
npm update -g @zapsterapi/cli
```

## Desinstalação

```bash theme={null}
npm uninstall -g @zapsterapi/cli
rm -rf ~/.zapsterapi
```

## Outras formas de instalação

Em v1, apenas o npm registry é suportado. **Homebrew, binário standalone e Docker** estão no roadmap pós-v1.

## Solução de problemas

### `EACCES: permission denied`

Seu npm global está em diretório que precisa de root. Use [nvm](https://github.com/nvm-sh/nvm) para gerenciar Node sem sudo, ou:

```bash theme={null}
sudo npm i -g @zapsterapi/cli
```

### `command not found: zapsterapi`

O diretório do npm global não está no `$PATH`. Verifique com:

```bash theme={null}
npm config get prefix
```

Adicione `<prefix>/bin` ao seu `$PATH`.