Help Center

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

브라우저에서 Wave CLI 승인 페이지가 열리고, 로그인된 계정과 CLI가 수행할 수 있는 작업이 표시됩니다. Wave CLI 승인을 클릭하면 페이지에 Wave CLI가 승인되었습니다 메시지와 이 탭을 닫고 터미널로 돌아가도 됩니다. 안내가 표시됩니다. 터미널이 인증 정보를 받아 보유한 세션 수를 알려 줍니다.

이 방식으로 로그인하면 Wave CLI라는 이름의 API 토큰이 생성되며, 승인 페이지에 표시된 것과 달리 모든 API 권한이 부여됩니다. 여기에는 세션 영구 삭제와 공유 권한도 포함됩니다. 권한을 좁히려면 브라우저 방식 대신 개발자 API 페이지에서 필요한 권한만 가진 토큰을 만든 뒤 wave login --token wave_api_...를 실행하세요.

다른 인증 방법도 두 가지 있습니다.

  • wave login --token wave_api_... — 직접 만든 토큰을 붙여 넣습니다. CI나 화면이 없는(headless) 환경에 적합합니다.
  • WAVE_API_KEY 환경 변수를 설정합니다. wave login으로 저장된 인증 정보보다 우선하므로, 명령 하나만 다른 계정으로 실행하기 쉽습니다.

wave whoami는 계정, 구독 상태, 세션 수를 보여 줍니다. wave logout은 이 기기에 저장된 인증 정보를 삭제합니다.

더 이상 제어할 수 없는 기기의 접근을 차단하려면 Wave 웹 앱의 설정 → 개발자 → API 토큰 및 웹훅에서 Wave CLI라는 이름의 토큰을 폐기하세요. 해당 토큰을 사용하던 모든 곳에서 무효화됩니다.

명령어

세션

  • wave sessions list — --limit(최대 100), --cursor, --since(7d, 2w, 1m 형식), --type, --folder(ID 또는 이름), --tag(여러 번 지정 가능), --tag-mode를 사용할 수 있습니다.
  • wave sessions get <id> — 세션 하나의 메타데이터, 요약, 메모, 태그, 통화 세부 정보를 가져옵니다.
  • wave sessions update <id> — --title, --notes, --tags, --favorite / --no-favorite를 설정합니다.
  • wave sessions add-folder <session_id> <folder_id> 및 wave sessions remove-folder — 한 세션이 여러 폴더에 속할 수 있으므로 폴더를 추가해도 기존 폴더는 유지됩니다.
  • wave sessions action-items get <session_id> 및 wave sessions action-items update <session_id> — 할 일을 버전과 함께 읽은 뒤 stdin이나 --from-file로 다시 씁니다. 필요하면 --if-match를 사용해, 앱에서 동시에 수정된 내용을 덮어쓰는 대신 요청이 거부되도록 할 수 있습니다.
  • wave sessions delete <id> — 영구 삭제하며, --force를 지정하지 않으면 확인을 요청합니다.

콘텐츠

  • wave search "your query" — 시맨틱 검색을 수행합니다. --limit(최대 50), --tag, --tag-mode를 사용할 수 있습니다.
  • wave transcript <id> — 전사를 출력합니다. --format에는 text(기본값), srt, segments를 지정할 수 있고, --speakers는 화자가 표시된 형식으로 출력하며, --json은 원본 응답을 반환합니다.
  • wave media urls <id> — 서명된 오디오 및 동영상 URL을 가져옵니다.
  • wave media download <id> — 오디오를 저장합니다. MP4로 받으려면 --video를, 특정 경로에 저장하려면 --output을 추가하세요.
  • wave bulk [ids...] — 최대 50개의 세션을 한 번에 내보냅니다. --summary와 --transcript를 사용할 수 있으며, --file은 한 줄에 하나씩 적힌 ID를 파일에서 읽습니다.
  • 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 — 공유받은 세션 하나를 읽습니다. 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" — 여러 번 실행해도 안전합니다. 같은 이름의 폴더가 있으면 기존 폴더를 반환합니다.

폴더 이름이나 색상을 변경하거나 폴더를 삭제하려면, 또는 다른 폴더 안에 하위 폴더로 넣으려면 개발자 API나 Wave 앱을 사용하세요.

이벤트와 웹훅

  • wave events list --ack, wave events ack <cursor>, wave events tail --interval 3 --ack --json — 웹훅 수신 서버 없이 새 세션을 받아 처리합니다. 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 개발자 API와 일대일로 대응하므로, CLI로 할 수 있는 작업은 직접 작성한 코드에서도 할 수 있습니다. 코드를 작성하기 전에 CLI로 응답 형태를 빠르게 확인해 보세요.

자주 묻는 질문

이 문서가 도움이 되었나요?

도움이 더 필요하신가요?

이메일로 문의하기

이 페이지의 내용