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 はコードを書く前にレスポンスの形を手早く確認するのにも便利です。
よくある質問
api.wave.co/cli にすべてのコマンドが例とともに掲載されています。wave --help(または各サブコマンドに --help)を実行すれば、ローカルでも同じ内容が表示されます。パッケージ自体はnpmjs.com/package/@waveai/cliにあります。
サインインは約1分で諦めてしまいます。Wave にサインインしているブラウザプロファイルで手続きを完了してから、もう一度 wave login を実行してください。ブラウザのないマシンでは wave login --token wave_api_... を使ってください。
API トークンは作成から1年で失効します。もう一度 wave login を実行して新しいトークンを発行してください。
はい — そのコマンドだけ WAVE_API_KEY を設定してください。保存されている認証情報を変更せずに上書きできます。
この記事は役に立ちましたか?
まだお困りですか?