The 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.

A first command

List your workspaces after authenticating. It doubles as proof that the token works:

Then list the agent projects in a workspace, using an id from that output:

Every command accepts --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.

The CLI source lives at github.com/voiceflow/cli, where releases and issues are tracked.

Voiceflow Documentation

    Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.