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

# Instalação

> Instale o binário repass globalmente com npm, pnpm ou yarn.

A CLI é distribuída como um pacote npm global (`@repass/cli`), que instala o binário `repass` no seu `PATH`.

<Note>
  Requer **Node.js >= 20**. Verifique sua versão com `node --version` antes de instalar.
</Note>

## Instale globalmente

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

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

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

## Verifique a instalação

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

Se o comando não for encontrado, confirme que o diretório global de binários do seu gerenciador de pacotes está no `PATH` (por exemplo, `$(npm config get prefix)/bin` para npm).

## Atualizando

<Note>
  A CLI não se autoatualiza. Rode o mesmo comando de instalação global periodicamente (ex.: `npm install -g @repass/cli@latest`) para pegar novos comandos e correções. Se você instalou a [skill de agente](/docs/cli/agentes), reinstale-a com `repass skills install --force` depois de atualizar, para manter comandos e flags em dia.
</Note>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="fingerprint" href="/docs/cli/autenticacao">
    Faça login por device flow ou com uma chave de API.
  </Card>

  <Card title="Convenções" icon="book" href="/docs/cli/convencoes">
    Anatomia de um comando, saída `--json` e modelo de risco.
  </Card>
</CardGroup>