CLI commands

cascade [OPTIONS] COMMAND [ARGS]

Top-level options

Option	Description
--version	Print the version and exit
-v, --verbose	Enable debug-level logs
--help	Show help and exit

Commands

cascade init

Scaffold cascade.yaml and the team-memory/ directory in the current repo.

cascade init [--force]

Option	Description
--force	Overwrite existing files if present

cascade configure

Manage credentials and defaults at ~/.config/cascade/config.yaml.

cascade configure show
cascade configure llm <provider> [--key K] [--model M] [--base-url U] [--set-default]
cascade configure vcs <provider> [--token T] [--base-url U] [--organization O] [--set-default]
cascade configure issue <provider> [--token T] [--base-url U] [--user U] [--set-default]

cascade ingest

Transcribe an audio or video file into a transcript YAML.

cascade ingest <source> [OPTIONS]

Option	Description
-o, --output FILE	Where to write the transcript
--backend	auto, faster-whisper, local-whisper, openai-api
--model	Whisper model size (tiny, base, small, medium, large)
--language	Force a language (ISO 639-1, e.g. en)
--no-diarization	Skip speaker identification
--meeting-id	Override the generated meeting ID

cascade extract

Extract user stories from a transcript YAML.

cascade extract <transcript_path> [OPTIONS]

Option	Description
-o, --output FILE	Where to write the stories YAML
--model	Override the configured LLM model for this call

cascade review

Walk through extracted stories interactively (accept / edit / reject / skip / quit).

cascade review <batch_path>

Decisions are saved after every action; safe to quit any time and resume later.

cascade prompt

Build directly from an ad-hoc prompt.

cascade prompt "<text>" [OPTIONS]

Option	Description
--language	Override the language profile
--base-branch	Branch to create the PR against (default main)
--no-pr	Stop after the local commit; don’t push or open a PR
--repo-root	Target repo path (default: current directory)

cascade ticket

Build from a tracker ticket.

cascade ticket <provider:identifier> [OPTIONS]

Option	Description
--language	Override the language profile
--base-branch	Branch to create the PR against (default main)
--no-pr	Stop after the local commit
--repo-root	Target repo path

cascade build

Run the full pipeline (plan, code, test, PR) on every approved story in a batch.

cascade build <batch_path> [OPTIONS]

Option	Description
--story N	Build only the N-th approved story (1-indexed)
--language	Override the language profile
--base-branch	Branch to create the PR against
--no-pr	Stop after the local commit
--repo-root	Target repo path

cascade status

Show the pipeline state for the current repo (transcripts and story batches counted).

cascade status