> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiceflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The vf command line interface for Voiceflow agents

> Manage Voiceflow agents, knowledge bases, transcripts, analytics, and environments from your terminal or CI with the official vf CLI.

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.

<Columns cols={2}>
  <Column>
    <Card title="Install" href="/cli/install" icon="download">
      One command on macOS, Linux, or Windows.
    </Card>
  </Column>

  <Column>
    <Card title="Authenticate" href="/cli/authentication" icon="key">
      Connect the CLI to your Voiceflow account.
    </Card>
  </Column>

  <Column>
    <Card title="Command reference" href="/cli/commands/overview" icon="terminal">
      Every command, flag, and default, generated from the CLI itself.
    </Card>
  </Column>

  <Column>
    <Card title="Migrating from the community CLI" href="/cli/migrating-from-the-community-cli" icon="arrow-right">
      Command mapping from the retired third-party voiceflow-cli.
    </Card>
  </Column>
</Columns>

## A first command

List the agents in a project after [authenticating](/cli/authentication):

```bash theme={null}
vf project list
```

Every command accepts `--help`, and the [command reference](/cli/commands/overview)
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](/api-reference/api-overview) when you are building an
  application or integration.
* Use the [MCP server](/mcp/overview) when you are working from a coding
  assistant.

The CLI source lives at [github.com/voiceflow/cli](https://github.com/voiceflow/cli),
where releases and issues are tracked.