Wave CLI

A Wave CLI coloca suas gravações no terminal. É um pacote npm chamado @waveai/cli que instala um comando wave, para que você possa listar sessões, pesquisá-las, imprimir uma transcrição, baixar áudio ou direcionar qualquer um desses resultados para um script. Todo comando que retorna dados aceita --json, o que facilita a combinação com outras ferramentas.

É gratuita em todos os planos da Wave e requer Node.js 20 ou mais recente. Funciona em macOS, Linux e Windows.

Instalação

npm install -g @waveai/cli

Para testar sem instalar nada:

npx @waveai/cli sessions list

Fazer login

Execute:

wave login

Seu navegador abre uma página Authorize Wave CLI ("Autorizar Wave CLI") mostrando a conta com a qual você está conectado e o que a CLI poderá fazer. Clique em Authorize CLI ("Autorizar CLI"), e a página confirma com You can close this tab and return to your terminal. ("Você pode fechar esta aba e voltar ao terminal."). O terminal capta a credencial e informa quantas sessões você tem.

Outras duas formas de autenticação:

• wave login --token wave_api_... — cole um token criado por você mesmo. Ótimo para CI e máquinas sem interface gráfica.
• Defina uma variável de ambiente WAVE_API_KEY. Ela tem prioridade sobre o que wave login armazenou, o que facilita executar um comando com uma conta diferente.

wave whoami mostra a conta, o estado da assinatura e a contagem de sessões. wave logout limpa a credencial armazenada nesta máquina.

Para cortar o acesso de uma máquina que você não controla mais, revogue o token chamado Wave CLI no aplicativo web da Wave, na aba Integrations ("Integrações"), depois em Developer API. Isso o desativa em todos os lugares onde foi usado.

Os comandos

Sessões

• wave sessions list — com --limit, --since (aceita 7d, 2w, 1m), --type, --folder, --tag (repetível) e --tag-mode.
• wave sessions get <id> — metadados, resumo, notas, tags e detalhes de chamadas telefônicas de uma sessão.
• wave sessions update <id> — define --title, --notes, --tags, --favorite / --no-favorite.
• wave sessions add-folder <session_id> <folder_id> e wave sessions remove-folder — as pastas não são exclusivas, então adicionar uma não remove outra.
• wave sessions action-items get <session_id> e wave sessions action-items update <session_id> — leia itens de ação com sua versão e depois grave-os de volta a partir de um arquivo ou stdin, opcionalmente protegidos com --if-match para que uma edição concorrente no aplicativo seja rejeitada em vez de sobrescrita.
• wave sessions delete <id> — permanente, e pede confirmação a menos que você use --force.

Conteúdo

• wave search "sua consulta" — pesquisa semântica, com filtros --limit e --tag.
• wave transcript <id> — imprime uma transcrição. --format aceita text (o padrão), srt ou segments; --speakers muda para saída com identificação de falantes, e --json retorna a resposta bruta.
• wave media urls <id> — URLs assinadas de áudio e vídeo.
• wave media download <id> — salva o áudio; adicione --video para MP4 ou --output para um caminho específico.
• wave bulk [ids...] — exporta até 50 sessões de uma vez, com --summary e --transcript.
• wave stats — contagens e durações divididas por tipo e plataforma.

Pastas

• wave folders list — nomes, ids e contagem de sessões.
• wave folders create "Customer research" --color "#6D28D9" — seguro para executar de novo; um nome correspondente retorna a pasta existente.

Eventos e webhooks

• wave events list --ack, wave events ack <cursor> e wave events tail --interval 3 --ack --json — consuma novas sessões sem hospedar um receptor de webhook. A Wave lembra sua posição por token.
• wave webhooks list / create / update / test / rotate-secret / delete — gerencie a entrega por push, incluindo o envio de um evento de teste e a rotação de um segredo de assinatura.

Configuração

wave config get, wave config set <key> <value> e wave config path gerenciam api_key, api_url e default_format no diretório de configuração do seu sistema operacional. wave config path imprime o arquivo exato, o que é útil quando você está apagando credenciais manualmente.

Algumas coisas que valem a pena automatizar

Fazer backup das gravações da última semana, incluindo transcrição:

wave sessions list --since 7d --limit 50 --json \
  | jq -r '.sessions[].id' \
  | xargs wave bulk --summary --transcript --json > backup.json

Observar novas sessões e agir sobre cada uma conforme ela chega:

wave events tail --interval 3 --ack --json

Perguntas frequentes