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

# Authenticate the vf CLI with your Voiceflow account

> Sign the vf CLI in interactively with vf auth login, check status with vf auth whoami, and pass a token directly for CI with the token flag.

The CLI stores credentials locally after an interactive login, and every
command also accepts a token directly for non-interactive use in CI.

## Interactive login

```bash theme={null}
vf auth login
```

Walks you through configuring credentials interactively. All fields are
optional, press Enter to skip any field you don't need.

## Check who you are

```bash theme={null}
vf auth whoami
```

Displays the current authentication status, or use the top-level alias
`vf whoami`.

## Sign out

```bash theme={null}
vf auth logout
```

Clears all stored credentials.

## Non-interactive use (CI)

Pass a token on any command with the global `--token` flag instead of storing
credentials:

```bash theme={null}
vf project list --token "$VOICEFLOW_TOKEN"
```

Store the token as a secret in your CI provider. Never commit it: the token
grants the same access as your account. Full flag reference:
[vf auth](/cli/commands/auth).