Wave CLI

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 CLI（「CLI を認証」）をクリックすると、ページに You can close this tab and return to your terminal.（「このタブを閉じてターミナルに戻って構いません」）と表示されます。ターミナル側は認証情報を受け取り、あなたのセッション数を表示します。

その他、認証には2つの方法があります:

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

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

もう管理していないマシンを遮断するには、Wave ウェブアプリの Integrations（「連携」）タブから Developer API に進み、Wave CLI という名前のトークンを無効化してください。これで、そのトークンが使われていたすべての場所で無効になります。

コマンド一覧

セッション

• wave sessions list — --limit、--since（7d、2w、1m を指定可能）、--type、--folder、--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> — アクションアイテムをバージョン情報つきで読み取り、ファイルまたは標準入力から書き戻します。--if-match を付けると、アプリ側で同時に行われた編集が上書きされず拒否されるようにできます。
• wave sessions delete <id> — 完全に削除されます。--force を渡さない限り確認を求めます。

コンテンツ

• wave search "検索クエリ" — セマンティック検索。--limit と --tag でフィルタできます。
• 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 が使えます。
• wave stats — タイプとプラットフォーム別の件数と長さの集計です。

共有

• 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" — 何度実行しても安全です。同じ名前がすでにあれば、既存のフォルダが返されます。

イベントと 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 — プッシュ配信の管理。テストイベントの送信や署名シークレットのローテーションもできます。

設定

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

よくある質問