> ## 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.

# CLI

> Camada de terminal oficial da Repass: o binário repass, sobre a mesma API do SDK.

O **`@repass/cli`** é a interface de terminal oficial da Repass, publicada no npm com o binário `repass`. É uma camada fina sobre o [`@repass/sdk`](/docs/sdk/visao-geral): cada comando resolve sua credencial e organização ativa e delega a chamada de negócio ao SDK. Nenhuma lógica de domínio própria vive na CLI.

<Note>
  A CLI cobre a mesma superfície de organização documentada na [Referência da API](/docs/convencoes/ids-e-recursos): programas, afiliados, links, cupons, conversões, comissões, payouts, notas fiscais, fraude, reprocessamento, eventos, webhooks e configurações. Além disso, oferece comandos imperativos de sessão local (`login`, `logout`, `whoami`, `org`, `config`) sem equivalente no SDK.
</Note>

## Para quem é

<CardGroup cols={3}>
  <Card title="Operadores" icon="terminal">
    Times que preferem o terminal ao painel para aprovar afiliados, rodar payouts ou investigar fraude no dia a dia.
  </Card>

  <Card title="Scripts e CI" icon="gears">
    Automação não interativa com chave de API, `--json` e exit codes previsíveis para orquestrar pipelines.
  </Card>

  <Card title="Agentes" icon="robot">
    Claude e outros agentes de terminal, guiados por uma skill embarcada com as boas práticas de uso seguro.
  </Card>
</CardGroup>

## Destaques

<CardGroup cols={2}>
  <Card title="Login por device flow" icon="key">
    `repass login` abre o navegador para você aprovar o acesso logado no painel, sem colar chave nenhuma no terminal.
  </Card>

  <Card title="Mais de 120 comandos" icon="table-list">
    Cobertura completa da API de organização, um grupo por recurso (`affiliates`, `payouts`, `webhooks`, `settings`...).
  </Card>

  <Card title="`--json` em toda chamada" icon="code">
    Saída legível por padrão; `--json` imprime o resultado cru para consumo por script.
  </Card>

  <Card title="Confirmação em ações sensíveis" icon="shield-halved">
    Comandos `destructive`/`sensitive` (banir afiliado, rodar payout, rotacionar segredo) pedem confirmação, ou `--yes` explícito fora de TTY.
  </Card>
</CardGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Instalação" icon="download" href="/docs/cli/instalacao">
    Node 20+, instale global com npm/pnpm/yarn e confira a versão.
  </Card>

  <Card title="Autenticação" icon="fingerprint" href="/docs/cli/autenticacao">
    Device flow, chave de API, organização ativa e `whoami`.
  </Card>

  <Card title="Convenções" icon="book" href="/docs/cli/convencoes">
    Anatomia de um comando, saída, corpo de requisição, risco e erros.
  </Card>

  <Card title="Uso com agentes" icon="robot" href="/docs/cli/agentes">
    A skill `repass-cli` para Claude e outros agentes de terminal.
  </Card>

  <Card title="Recursos: Programs" icon="folder-tree" href="/docs/cli/recursos/programs">
    Primeiro grupo de comandos da referência: programas de afiliados.
  </Card>
</CardGroup>