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/cliPara experimentar sem instalar nada:
npx @waveai/cli sessions listEntrar
Execute:
wave loginO 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 quewave loginarmazenou, 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(aceita7d,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>ewave 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>ewave 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-matchpara 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),--tage--tag-mode.wave transcript <id>— imprime uma transcrição.--formataceitatext(o padrão),srtousegments;--speakersmuda para saída com identificação de interlocutores, e--jsondevolve a resposta bruta.wave media urls <id>— URLs assinadas de áudio e vídeo.wave media download <id>— salva o áudio; adicione--videopara MP4 ou--outputpara um caminho específico.wave bulk [ids...]— exporta até 50 sessões de uma vez, com--summarye--transcript.--filelê os ids de um arquivo, um por linha.wave stats— contagens e durações detalhadas por tipo e plataforma, opcionalmente entre--sincee--until.
Compartilhamento
wave shared list— sessões que outros usuários do Wave compartilharam com você, com--limite--cursor.wave shared get <owner_id> <session_id>,wave shared transcript,wave shared action-itemsewave shared media— leia uma delas.transcriptaceita as mesmas flags--formate--speakersquewave 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--messageopcional 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-everyonepara 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>ewave 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.createaceita--urle--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.jsonObservar novas sessões e agir em cada uma assim que chegar:
wave events tail --interval 3 --ack --jsonOs 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
api.wave.co/cli lista todos os comandos com exemplos, e wave --help (ou --help em qualquer subcomando) imprime o mesmo conteúdo localmente. O próprio pacote está em npmjs.com/package/@waveai/cli.
O login expira depois de cerca de um minuto. Certifique-se de concluí-lo no perfil do navegador em que está conectado ao Wave e depois execute wave login novamente. Em uma máquina sem navegador, use wave login --token wave_api_....
Os tokens de API expiram um ano após serem criados. Execute wave login novamente para gerar um novo.
Sim — defina WAVE_API_KEY apenas para aquele comando. Isso substitui a credencial armazenada sem alterá-la.
Este artigo foi útil?
Ainda precisa de ajuda?
Compartilhar sessões a partir do Claude, ChatGPT, API e CLI
Leia as sessões que outras pessoas compartilharam com você e compartilhe as suas, a partir de um assistente de IA, do seu próprio código ou do terminal.
Automatize o Wave com o Zapier
Envie cada sessão concluída — resumo, transcrição, título e link — para mais de 8.000 apps assim que o Wave terminar de processá-la, sem precisar de código.