Help Center

CLI do Wave

Instale o comando wave, entre pelo navegador e liste, pesquise, exporte e organize as suas gravações a partir do terminal.

Última atualização:

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

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

Instalação

npm install -g @waveai/cli

Para experimentar sem instalar nada:

npx @waveai/cli sessions list

Entrar

Execute:

wave login

O seu navegador abre uma página Authorize Wave CLI ("Autorizar Wave CLI") mostrando a conta com a qual está autenticado e o que a CLI poderá fazer. Clique em Authorize Wave CLI, e a página confirma com Wave CLI is authorized — You can close this tab and go back to your terminal. O terminal recebe a credencial e informa quantas sessões tem.

Entrar desta forma cria um token de API chamado Wave CLI com todas as permissões de API — incluindo apagar sessões permanentemente e compartilhá-las — mesmo que a página de autorização liste menos permissões. Se quiser algo mais restrito, não use o fluxo do navegador: crie um token apenas com as permissões de que precisa na página Developer API e execute wave login --token wave_api_... em vez disso.

Outras duas formas de se autenticar:

  • wave login --token wave_api_... — cole um token que você mesmo criou. Bom 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 como outra conta.

wave whoami mostra a conta, o estado da assinatura e o número de sessões. wave logout apaga 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 do Wave em Settings → Developers → API tokens and webhooks ("Configurações → Desenvolvedores → Tokens de API e webhooks"). Isso o invalida em todos os lugares onde foi usado.

Os comandos

Sessões

  • wave sessions list — com --limit (até 100), --cursor, --since (aceita 7d, 2w, 1m), --type, --folder (id ou nome), --tag (repetível) e --tag-mode.
  • wave sessions get <id> — metadados, resumo, notas, tags e detalhes de chamada telefônica de uma sessão.
  • wave sessions update <id> — defina --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 os itens de ação com sua versão e depois grave-os de volta a partir do stdin ou de --from-file, opcionalmente protegido com --if-match para que uma edição simultânea no aplicativo seja rejeitada em vez de sobrescrita.
  • wave sessions delete <id> — permanente, e pede confirmação a menos que você passe --force.

Conteúdo

  • wave search "sua consulta" — pesquisa semântica, com --limit (até 50), --tag e --tag-mode.
  • 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 interlocutores, e --json devolve 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. --file lê os ids de um arquivo, um por linha.
  • wave stats — contagens e durações detalhadas por tipo e plataforma, opcionalmente entre --since e --until.

Compartilhamento

  • wave shared list — sessões que outros usuários do Wave compartilharam com você, com --limit e --cursor.
  • wave shared get <owner_id> <session_id>, wave shared transcript, wave shared action-items e wave shared media — leia uma delas. transcript aceita as mesmas flags --format e --speakers que wave transcript.
  • wave sessions list --include-shared — mistura sessões compartilhadas na sua lista, cada uma marcada com quem a compartilhou.
  • wave sessions share <id> — imprime um link de convite. Adicione --email a@x.com,b@y.com (até 10) e uma --message opcional para enviar convites por e-mail.
  • wave sessions access <id> — quem tem acesso, além de convites por e-mail pendentes.
  • wave sessions unshare <id> com --recipient <user_id>, --email <address> ou --everyone — remova uma pessoa, cancele um convite pendente ou redefina o link e remova todos. wave sessions share reset <id> redefine o link; adicione --remove-everyone para também tirar o acesso de todos.

As sessões compartilhadas são somente leitura, e wave search abrange apenas as suas próprias. Mais em Compartilhar sessões do Claude, ChatGPT, da API e da CLI.

Pastas

  • wave folders list — nomes, ids e número de sessões.
  • wave folders create "Customer research" --color "#6D28D9" — seguro para executar novamente; um nome correspondente devolve a pasta já existente.

Para renomear, recolorir ou apagar uma pasta, ou para colocá-la dentro de outra como subpasta, use a Developer API ou o aplicativo do Wave.

Eventos e webhooks

  • wave events list --ack, wave events ack <cursor> e wave events tail --interval 3 --ack --json — consuma novas sessões sem precisar hospedar um receptor de webhook. O Wave memoriza a 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. create aceita --url e --events (session.completed, session.updated, session.deleted).

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 vale a pena automatizar com scripts

Fazer backup das gravações da última semana, incluindo a 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 em cada uma assim que chegar:

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

Os comandos correspondem um a um à Wave Developer API, então tudo o que a CLI faz você também pode fazer no seu próprio código — e a CLI é uma forma rápida de ver como é uma resposta antes de escrever qualquer coisa.

Perguntas frequentes

Este artigo foi útil?

Ainda precisa de ajuda?

E-mail para o suporte

Nesta página