メインコンテンツへスキップ

​
前提条件

​
インストール

npm install -g @plaud-ai/cli

​
クイックスタート

plaud login # ブラウザ経由でログイン 
plaud files # 録音データの閲覧 
plaud search "Q2" # キーワードで録音データを検索 
plaud summary <id> # AI 要約の確認 
plaud transcript <id> # 文字起こし全体の確認

​
コマンドリファレンス

​
認証

plaud login # ブラウザ経由でログイン (トークンは自動保存されます)  
plaud logout # ログアウトおよび認証の取り消し 
plaud me # 現在のアカウント情報の表示

​
閲覧

plaud files # 最新の録音データ（最新ページ） 
plaud files --page 2 --page-size 50 
plaud recent # 過去 7 日間の録音データ 
plaud recent --days 30 # 過去 30 日間の録音データ 
plaud today # 今日の録音データのみ
plaud files コマンドのオプション
オプション説明デフォルト値
-p, --pageページ番号 (1～1000)1
-s, --page-size1 ページあたりの件数 (10～100)20

​
検索

plaud search <キーワード> 
plaud search "週次定例" --from 2026-04-01 --to 2026-04-30 
plaud search "オンボーディング" --max 10
録音ファイル名を対象とした、クライアントサイドでのキーワード検索です (英語での大文字・小文字は区別しません) 。直近の録音データ最大 500 件を検索対象とします。
オプション説明
--from <YYYY-MM-DD>検索対象期間の開始日 (指定日を含む)
--to <YYYY-MM-DD>検索対象期間の終了日 (指定日を含む)
--max <n>表示する最大結果件数 (デフォルト：50)

​
録音データの詳細確認

plaud file <id> # 完全なメタデータと利用可能状況の確認 
plaud audio <id> # 音声ファイルのダウンロード URL (24 時間有効) 
plaud transcript <id> # タイムスタンプ付きの文字起こし 
plaud transcript <id> -o transcript.txt # ファイルへの保存 
plaud summary <id> # AI 要約 (Markdown 形式) 
plaud summary <id> -o summary.md # ファイルへの保存

​
ユーティリティ

plaud version # インストール済みのバージョンとビルド情報の表示 
plaud update # 最新バージョンの確認とアップグレードコマンドの表示

​
データ参照

​
plaud files および plaud file のフィールド

フィールド説明
id一意の録音 ID (他のコマンドで指定する際に使用)
name録音データ名
created_at作成日時 (ISO 8601形式)
duration録音時間
plaud file <id> のみに追加されるフィールド
フィールド説明
start_at録音開始日時 (ISO8601形式)
serial_numberデバイスのシリアル番号
audio音声ファイルのダウンロード可否
transcript文字起こしの利用可否
summaryAI 要約の利用可否

​
終了コード

コード意味
0成功
1無効な引数、または不明なエラー
2認証失敗 (plaud login を実行してください) `
3ネットワークエラー (接続状況を確認してください)
4リクエストのタイムアウト
スクリプトやパイプ処理で標準出力 (stdout) をクリーンに保つため、エラーはすべて標準エラー出力 (stderr) に出力されます。 ✖ [AUTH_FAILED] トークンが無効または期限切れです。「plaud login」を実行してください。

​
設定

トークンは~/.plaud/tokens.jsonに自動で保存・管理されるため、手動での編集は不要です。 より高度な設定を行う場合は、以下の任意の設定ファイル~/.plaud/cli.yaml で構成できます。 
api_base: "https://platform.plaud.ai/developer/api" timeout:30000 # milliseconds
環境変数を設定した場合は、構成ファイルおよび組み込みのデフォルト値よりも優先されます。
変数目的
PLAUD_API_BASEAPI のベース URL を上書き
PLAUD_CLIENT_ID / PLAUD_CLI_CLIENT_IDOAuth クライアント ID
PLAUD_CLIENT_SECRETOAuth クライアントシークレット
PLAUD_AUTH_URL認可エンドポイント
PLAUD_TOKEN_URLトークン交換エンドポイント
PLAUD_REFRESH_URLトークンリフレッシュのエンドポイント

​
アップグレード

npm install -g @plaud-ai/cli@latest
または、事前に最新バージョンを確認する場合： 
plaud update

​
アンインストール

npm uninstall -g @plaud-ai/cli 
rm -rf ~/.plaud

​
トラブルシューティング

症状解決策
401 / “Not authenticated”plaud login を実行する
plaud: command not foundターミナルを再起動する。エラーなしで npm install -g @plaud-ai/cli が完了しているか確認する
トークンのリフレッシュエラー~/.plaud/tokens.json を削除し、再度 plaud login を実行する
ログイン時にブラウザが開かないターミナルに表示された URL をコピーし、ブラウザで手動で開く
npx で @plaud-ai/cli が E404 を返すnpm cache clean --force を実行して再試行する