Wave for Agents · CLI

The Wave command-line tool

A scriptable surface for your Wave recordings. List sessions, fetch transcripts, run semantic search, and pipe outputs into anything else your shell can do — grep, jq, your editor, your agent, your favorite local LLM.

Same data as the APIThe CLI is a thin wrapper around the Wave API. Anything the API can do, the CLI exposes as a subcommand.
Token-based authLog in once with a wave_api_ token. The CLI stores it locally and uses it for every subsequent command.
JSON-out for pipelinesEvery command emits JSON when you ask for it. Pipe into jq, fzf, your shell scripts, or another tool.

Typical commands

# Log in once with a Wave API token
wave auth login

# List your recent recordings
wave sessions list --limit 10

# Fetch a transcript by ID
wave sessions get SESSION_ID --include transcript

# Semantic search across your recordings
wave search "decisions about pricing" --json | jq .results

# Pipe a transcript into another tool
wave sessions get SESSION_ID --include transcript --format text | grep -i action

What it’s for

See also

For non-shell access: the Wave REST API for direct integration, and the Wave MCP server for Claude, ChatGPT, Cursor, and other agent clients.

Wave app screenshot showing meeting transcription
Wave AI note taker background pattern
Start today

Wave. Catch every word