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

첫 팟캐스트 만들기

주제 하나로 짧은 단독 진행 에피소드를 생성합니다:

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_로 시작합니다.

키를 사용할 수 있게 하기

두 가지 방법이 있습니다. 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는 최소 하나의 --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>