CLI クイックスタート

CLI をインストールする

npm install -g @marswave/listenhub-cli

これで listenhub バイナリが PATH に入ります。確認します：

listenhub --version
listenhub --help

ログインする

listenhub auth login

ブラウザが開いて OAuth を完了します。承認すると、CLI はトークンを ~/.config/listenhub/credentials.json（モード 0600）に保存し、サインインしたアカウントを表示します。トークンは自動で更新されるため、この操作はマシンごとに一度だけです。

セッションはいつでも確認できます：

listenhub auth status

最初のポッドキャストを作成する

トピックから、スピーカー 1 人の短いエピソードを生成します：

listenhub podcast create --query "AI agent trends in 2026" --mode quick

このコマンドはジョブを送信し、エピソードが完成するまでポーリングして、スピナーで進捗を表示します。完了するとエピソード ID、タイトル、ステータスを出力します。

podcast create で押さえておきたいフラグ：

スピーカーを省略すると、CLI は検出した言語のデフォルトを選びます。声を自分で選ぶには、まずスピーカーを一覧し（openapi ネームスペースが照会可能な一覧を提供します。後述の API キーを使う手順 を参照）、--speaker または --speaker-id を渡します。

結果を読み取る

デフォルトではコマンドが生成の完了まで待つため、最終出力はすでに完成したエピソードを反映しています：

✓ Podcast created

  ID:     ep_xxx
  Title:  AI agent trends in 2026
  Status: success

最近のエピソードはいつでも一覧できます：

listenhub podcast list

API キーを作成する

listenhub.ai/settings/api-keys でキーを作成します。キーは lh_sk_ で始まります。

キーを利用できるようにする

方法は 2 つあります。CI や一時的な環境では、環境変数を設定してください。CLI はこちらを先に読み取ります：

export LISTENHUB_API_KEY="lh_sk_..."

ローカルで恒久的に設定する場合は、代わりにディスクへ保存します。このコマンドはキーの入力を求め、~/.config/listenhub/openapi.json（モード 0600）に書き込みます：

listenhub openapi config set-key

設定内容（および実際に有効になっている取得元）を確認するには：

listenhub openapi config show

スピーカーを選ぶ

OAuth の手順とは異なり、openapi podcast create は少なくとも 1 つの --speaker-id を必要とします。利用可能な音声を一覧して ID をコピーします：

listenhub openapi speakers list --language en

Name、ID、Gender、Language を含む表が出力されます。--speaker-id に渡すのは ID 列の値です。

API キーでポッドキャストを作成する

listenhub openapi podcast create \
  --query "AI agent trends in 2026" \
  --speaker-id <speaker-id> \
  --mode quick

OAuth のコマンドと同様に、ジョブを送信して完了までポーリングし、終わるとエピソードの詳細を出力します。--no-wait、--timeout <seconds>（デフォルト 300）、--json の各フラグも同じように使えます。マルチボイスのエピソードにするには --speaker-id を複数回渡し、内容の根拠を与えるには --source-url / --source-text を追加します。

後から ID でエピソードを取得します：

listenhub openapi podcast get <episode-id>