@wave-av/cli

Command-line interface for the WAVE streaming platform. Manage streams, productions, and infrastructure from your terminal.

Installation

# npm
npm install -g @wave-av/cli

# pnpm
pnpm add -g @wave-av/cli

# npx (one-off usage)
npx @wave-av/cli stream list

Quick start

# Authenticate
wave login

# Create a stream
wave stream create --title "My Stream" --protocol webrtc

# List your streams
wave stream list

# Start streaming
wave stream start <stream-id>

Authentication

OAuth device flow (recommended)

wave login
# Opens browser for authentication

Direct API key

wave login --api-key wave_live_your_key_here

Multi-project context

# Separate environments
wave login --project-name production
wave login --project-name staging

# Switch context
wave config set currentProject staging

# Override per-command
wave stream list --project production

CI/CD environment variables

export WAVE_API_KEY=wave_live_your_key_here
export WAVE_ORG_ID=org_123
wave stream list  # Uses env vars automatically

Command groups

| Group | Description | Example | | -------------- | ----------------------- | ------------------------------------------ | | stream | Live stream management | wave stream create --title "Live" | | studio | Multi-camera production | wave studio start <id> | | clip | Stream clips | wave clip create --stream-id <id> | | editor | Video editor | wave editor render <id> | | voice | Voice synthesis | wave voice synthesize --text "Hello" | | phone | Telephony | wave phone call --to +1234567890 | | collab | Collaboration rooms | wave collab room create | | captions | Live captions | wave captions generate --stream-id <id> | | chapters | Chapter detection | wave chapters detect --recording-id <id> | | ai | AI assistant | wave ai assistant start | | transcribe | Transcription | wave transcribe create --stream-id <id> | | sentiment | Sentiment analysis | wave sentiment analyze --text "..." | | search | Content search | wave search query --q "keyword" | | scene | Scene detection | wave scene detect --recording-id <id> | | fleet | Device management | wave fleet list | | ghost | AI director | wave ghost suggestions | | mesh | Multi-region | wave mesh status | | edge | Edge processing | wave edge cache status | | analytics | Streaming analytics | wave analytics viewers | | prism | Camera discovery | wave prism discover | | zoom | Zoom integration | wave zoom meeting create | | vault | Recording archive | wave vault recordings list | | marketplace | Plugin marketplace | wave marketplace search | | connect | Integrations | wave connect integrations | | distribution | Simulcast | wave distribution simulcast | | desktop | Desktop nodes | wave desktop nodes | | signage | Digital signage | wave signage displays list | | qr | QR codes | wave qr create --data "https://..." | | audience | Engagement | wave audience polls create | | creator | Monetization | wave creator revenue | | podcast | Podcast management | wave podcast episodes list | | slides | Presentations | wave slides convert | | usb | USB devices | wave usb devices list | | notify | Notifications | wave notify send --to [email protected] | | drm | Content protection | wave drm licenses list | | billing | Billing & usage | wave billing status |

Developer tools

| Command | Description | | ---------------------- | -------------------------------------- | | wave listen | Forward webhook events to localhost | | wave logs tail | Real-time API log streaming | | wave trigger <event> | Fire test webhook events | | wave dev | Combined listen + logs for development | | wave open [page] | Open WAVE dashboard in browser | | wave init [name] | Scaffold a new project from templates |

Global flags

| Flag | Description | | ----------------------- | ------------------------------------------------ | | -o, --output <format> | Output format: table (default), json, yaml | | --project <name> | Override project context | | --org <id> | Override organization | | -c, --confirm | Skip confirmation prompts (for scripting) | | --no-color | Disable colored output | | --debug | Verbose debug logging |

Environment variables

| Variable | Description | | --------------------- | --------------------------------- | | WAVE_API_KEY | Override API key (skips keychain) | | WAVE_ORG_ID | Override organization ID | | WAVE_PROJECT | Override project name | | WAVE_OUTPUT_FORMAT | Override output format | | WAVE_BASE_URL | Override API base URL | | WAVE_NO_COLOR=1 | Disable colors | | WAVE_NO_TELEMETRY=1 | Disable telemetry |

Shell completions

# Bash
wave completion bash > ~/.bashrc.d/wave
source ~/.bashrc.d/wave

# Zsh
wave completion zsh > ~/.zsh/completions/_wave

# Fish
wave completion fish > ~/.config/fish/completions/wave.fish

CI/CD example

# .github/workflows/deploy-stream.yml
name: Deploy Live Stream
on: workflow_dispatch
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - run: npm install -g @wave-av/cli
      - run: wave stream create --title "Auto Stream" --protocol webrtc --confirm --output json
        env:
          WAVE_API_KEY: ${{ secrets.WAVE_API_KEY }}

Related packages

• @wave-av/sdk — TypeScript SDK (34 API modules)
• @wave-av/adk — Agent Developer Kit
• @wave-av/mcp-server — MCP server for AI tools
• @wave-av/create-app — Scaffold a new project
• @wave-av/workflow-sdk — Workflow orchestration

License

MIT