vf CLI is the official command line interface for Voiceflow. It covers the
same surface as the dashboard for day-to-day operations: inspect and update
agents, manage knowledge base documents, fetch transcripts and analytics, run
evaluations, and publish environments, all scriptable from your terminal or CI.
The CLI is built for automation first. Every command supports structured output
(--output-format json, yaml, table, or toon), a --jq flag for inline
filtering, and --dry-run to preview any request before it executes. Running
inside a coding agent such as Claude Code or Cursor enables --agent-mode
automatically, which switches on structured errors designed for tools to parse.
Install
One command on macOS, Linux, or Windows.
Authenticate
Connect the CLI to your Voiceflow account.
Command reference
Every command, flag, and default, generated from the CLI itself.
Migrating from the community CLI
Command mapping from the retired third-party voiceflow-cli.
A first command
List the agents in a project after authenticating:--help, and the command reference
carries the full tree. The reference is generated from the CLI source at a
pinned version, so it always matches the binary it documents.
Where the CLI fits
- Use the CLI for scripting, CI pipelines, and bulk operations.
- Use the APIs when you are building an application or integration.
- Use the MCP server when you are working from a coding assistant.