Docs · Reference

Config, env, and exit codes.

Config file

TOML. Each profile is a separate file under profiles/.

toml

# ~/.config/v0cli/profiles/default.toml  (XDG)
# or ~/Library/Application Support/v0cli/profiles/default.toml on macOS
[auth]
api_key = "v1_..."

[defaults]
model_id = "v0-pro"
privacy = "private"

[rate_limits]
# warn when under N remaining requests
warn_threshold = 10

Environment variables

Var

Effect

V0_API_KEY

Overrides profile API key.

V0_PROFILE

Active profile name (default: default).

V0_BASE_URL

Override API base (default api.v0.dev/v1).

V0_CLI_HOME

Pin all on-disk state to a custom dir.

NO_COLOR

Disable ANSI colors.

FORCE_COLOR

Force ANSI colors in non-TTY.

Exit codes

Code

Meaning

0

Success.

1

Generic error (network, runtime).

2

T2 confirm required in JSON mode (missing --yes).

3

Rate limit exhausted.

4

Validation failure (bad params).

5

T3 intent token required / invalid / consumed.

124

chat wait timeout.

130

User cancelled (Ctrl-C, v0 init).

← Previous Safety

← Back to landing Star on GitHub ↗