Wave CLI

O Wave CLI leva as tuas gravações para o terminal. É um pacote npm chamado @waveai/cli que instala um comando wave, para poderes listar sessões, pesquisá-las, imprimir uma transcrição, descarregar áudio ou encaminhar qualquer um desses resultados para um script. Todos os comandos que devolvem dados aceitam --json, o que facilita a combinação com outras ferramentas.

É gratuito em qualquer plano Wave e precisa do 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

Iniciar sessão

Executa:

wave login

O teu navegador abre uma página Authorize Wave CLI ("Autorizar Wave CLI") a mostrar a conta com que tens sessão iniciada e o que o CLI poderá fazer. Clica em Authorize CLI, e a página confirma com You can close this tab and return to your terminal. O terminal recebe a credencial e indica quantas sessões tens.

Duas outras formas de autenticação:

• wave login --token wave_api_... — cola um token que tu próprio criaste. Ideal para CI e máquinas sem interface gráfica.
• Define uma variável de ambiente WAVE_API_KEY. Tem prioridade sobre o que wave login guardou, o que facilita executar um comando como uma conta diferente.

wave whoami mostra a conta, o estado da subscrição e o número de sessões. wave logout apaga a credencial guardada nesta máquina.

Para cortar o acesso a uma máquina que já não controlas, revoga o token chamado Wave CLI na aplicação web do Wave, no separador Integrations ("Integrações"), depois Developer API. Isso desativa-o em todos os locais 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, etiquetas 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, por isso adicionar uma não remove outra.
• wave sessions action-items get <session_id> e wave sessions action-items update <session_id> — lê tarefas com a respetiva versão e depois grava-as de volta a partir de um ficheiro ou de stdin, opcionalmente protegido com --if-match para que uma edição concorrente na aplicação seja rejeitada em vez de sobrescrita.
• wave sessions delete <id> — permanente, e pede confirmação a menos que passes --force.

Conteúdo

• wave search "a tua pesquisa" — pesquisa semântica, com filtros --limit e --tag.
• wave transcript <id> — imprime uma transcrição. --format aceita text (predefinição), srt ou segments; --speakers muda para saída identificada por orador, e --json devolve a resposta em bruto.
• wave media urls <id> — URLs assinados de áudio e vídeo.
• wave media download <id> — guarda o áudio; adiciona --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.

Partilha

• wave shared list — sessões que outros utilizadores do Wave partilharam contigo, com --limit e --cursor.
• wave shared get <owner_id> <session_id>, wave shared transcript, wave shared action-items e wave shared media — lê uma sessão partilhada. transcript aceita as mesmas flags --format e --speakers que wave transcript.
• wave sessions list --include-shared — mistura sessões partilhadas na tua lista, cada uma marcada com quem a partilhou.
• wave sessions share <id> — imprime um link de convite. Adiciona --email a@x.com,b@y.com (até 10) e opcionalmente --message para enviar convites por email.
• wave sessions access <id> — quem tem acesso, mais convites por email pendentes.
• wave sessions unshare <id> com --recipient <user_id>, --email <address> ou --everyone — remove uma pessoa, cancela um convite pendente, ou reinicia o link e remove todos. wave sessions share reset <id> reinicia o link; adiciona --remove-everyone para também retirar o acesso de todos.

As sessões partilhadas são apenas de leitura, e wave search abrange apenas as tuas próprias sessões. Mais informações em Sharing Sessions from Claude, ChatGPT, the API and the CLI.

Pastas

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

Eventos e webhooks

• wave events list --ack, wave events ack <cursor> e wave events tail --interval 3 --ack --json — consome novas sessões sem alojares um recetor de webhooks. O Wave guarda a tua posição por token.
• wave webhooks list / create / update / test / rotate-secret / delete — gere 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 gerem api_key, api_url e default_format no diretório de configuração do teu sistema operativo. wave config path imprime o ficheiro exato, o que é útil quando estás a apagar credenciais manualmente.

Algumas ideias úteis para automatizar

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

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

Vigiar novas sessões e agir sobre cada uma assim que surge:

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

Perguntas frequentes