Help Center

Wave CLI

wave コマンドをインストールしてブラウザからサインインし、ターミナルから録音の一覧表示、検索、エクスポート、整理ができます。

最終更新日:

Wave CLI を使うと、録音データをターミナルで扱えるようになります。これは @waveai/cli という npm パッケージで、wave コマンドをインストールすると、セッションの一覧表示や検索、文字起こしの表示、音声のダウンロード、あるいはそれらをスクリプトにパイプすることができます。データを返すコマンドはすべて --json を受け付けるので、他のツールと組み合わせて使うのも簡単です。

すべての Wave プランで無料で使え、Node.js 20 以降が必要です。macOS、Linux、Windows で動作します。

インストール

npm install -g @waveai/cli

インストールせずに試すには:

npx @waveai/cli sessions list

サインイン

次を実行します:

wave login

ブラウザが開き、Authorize Wave CLI(「Wave CLI を承認」)ページが表示され、サインイン中のアカウントと CLI が実行できる操作が示されます。Authorize Wave CLI をクリックすると、ページに Wave CLI is authorized(「Wave CLI が承認されました」)と表示されます — You can close this tab and go back to your terminal.(「このタブを閉じてターミナルに戻って構いません」)。ターミナル側は認証情報を受け取り、セッション数を表示します。

この方法でサインインすると、API 権限をすべて持つ Wave CLI という名前の API トークンが作成されます — セッションの完全削除や共有も含めて、承認ページに表示されている以上の権限です。もっと限定的な権限にしたい場合は、ブラウザでの認証フローをスキップし、Developer API ページで必要な権限だけを持つトークンを作成して、代わりに wave login --token wave_api_... を実行してください。

認証にはほかに2つの方法があります:

  • wave login --token wave_api_... — 自分で作成したトークンを貼り付けます。CI やヘッドレス環境に向いています。
  • WAVE_API_KEY 環境変数を設定する。これは wave login が保存した情報より優先されるため、特定のコマンドだけ別アカウントで実行したいときに便利です。

wave whoami はアカウント、サブスクリプションの状態、セッション数を表示します。wave logout はこのマシンに保存された認証情報を消去します。

もう管理下にないマシンを切り離したい場合は、Wave のウェブアプリの Settings → Developers → API tokens and webhooks(「設定 → 開発者 → API トークンと Webhook」)から Wave CLI という名前のトークンを取り消してください。これにより、そのトークンが使われていたすべての場所で無効になります。

コマンド一覧

セッション

  • wave sessions list — --limit(最大100)、--cursor、--since(7d、2w、1m などを指定可能)、--type、--folder(id または名前)、--tag(複数指定可)、--tag-mode が使えます。
  • wave sessions get <id> — 1つのセッションのメタデータ、サマリー、メモ、タグ、通話詳細を取得します。
  • wave sessions update <id> — --title、--notes、--tags、--favorite / --no-favorite を設定します。
  • wave sessions add-folder <session_id> <folder_id> と wave sessions remove-folder — フォルダは排他的ではないため、1つ追加しても他のフォルダが外れることはありません。
  • wave sessions action-items get <session_id> と wave sessions action-items update <session_id> — アクションアイテムをバージョン情報付きで読み取り、標準入力または --from-file から書き戻せます。--if-match を付ければ、アプリ側で同時に編集があった場合に上書きせず拒否できます。
  • wave sessions delete <id> — 完全削除です。--force を付けない限り確認を求められます。

コンテンツ

  • wave search "検索クエリ" — セマンティック検索です。--limit(最大50)、--tag、--tag-mode が使えます。
  • wave transcript <id> — 文字起こしを表示します。--format は text(デフォルト)、srt、segments を指定でき、--speakers で話者ラベル付き出力に切り替わります。--json は生のレスポンスを返します。
  • wave media urls <id> — 署名付きの音声・動画 URL を取得します。
  • wave media download <id> — 音声を保存します。--video を付けると MP4 で、--output で保存先を指定できます。
  • wave bulk [ids...] — 最大50件のセッションを一度にエクスポートします。--summary と --transcript が使えます。--file はファイルから id を1行ずつ読み込みます。
  • wave stats — 種類とプラットフォームごとの件数と時間を集計します。--since と --until で期間を絞り込めます。

共有

  • wave shared list — 他の Wave ユーザーがあなたに共有したセッションの一覧です。--limit と --cursor が使えます。
  • wave shared get <owner_id> <session_id>、wave shared transcript、wave shared action-items、wave shared media — 共有されたセッションを1つ読み取ります。transcript は wave transcript と同じ --format と --speakers フラグを使えます。
  • wave sessions list --include-shared — 共有されたセッションを一覧に混ぜて表示し、それぞれ誰が共有したかが表示されます。
  • wave sessions share <id> — 招待リンクを表示します。--email a@x.com,b@y.com(最大10件)と任意の --message を付けると、メールで招待できます。
  • wave sessions access <id> — アクセス権を持つ人と、保留中のメール招待を表示します。
  • wave sessions unshare <id> に --recipient <user_id>、--email <address>、--everyone を付けて — 特定の人を削除したり、保留中の招待を取り消したり、リンクをリセットして全員のアクセスを削除したりできます。wave sessions share reset <id> はリンクをリセットします。--remove-everyone を付けると全員のアクセス権も削除します。

共有されたセッションは読み取り専用で、wave search は自分のセッションのみが対象です。詳しくはClaude、ChatGPT、API、CLI からセッションを共有・閲覧するをご覧ください。

フォルダ

  • wave folders list — 名前、id、セッション数を表示します。
  • wave folders create "Customer research" --color "#6D28D9" — 何度実行しても安全です。同じ名前があれば既存のフォルダを返します。

フォルダの名前変更、色の変更、削除、または別のフォルダの中へのサブフォルダとしての移動には、Developer API または Wave アプリを使ってください。

イベントと Webhook

  • wave events list --ack、wave events ack <cursor>、wave events tail --interval 3 --ack --json — Webhook の受信サーバーを用意せずに新しいセッションを取得できます。Wave はトークンごとに現在位置を記憶します。
  • wave webhooks list / create / update / test / rotate-secret / delete — プッシュ配信を管理します。テストイベントの送信や署名シークレットのローテーションも可能です。create は --url と --events(session.completed、session.updated、session.deleted)を受け付けます。

設定

wave config get、wave config set <key> <value>、wave config path は OS の設定ディレクトリ内にある api_key、api_url、default_format を管理します。wave config path は設定ファイルの正確な場所を表示するので、認証情報を手動で消去したいときに便利です。

スクリプト化しておくと便利なこと

過去1週間分の録音を文字起こし込みでバックアップする:

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

新しいセッションを監視して、届くたびに処理する:

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

コマンドはWave Developer APIと1対1で対応しているので、CLI でできることは自分のコードからも実行できます。また、CLI はコードを書く前にレスポンスの形を手早く確認するのにも便利です。

よくある質問

この記事は役に立ちましたか?

まだお困りですか?

メールで問い合わせ

このページの内容