CLI overview - Voyant

The Voyant CLI is the terminal interface to the managed platform. It is designed for developers, CI jobs, and agents that need repeatable control-plane operations.

Install

npm install -g @voyant-travel/cli
voyant --version

Log in

voyant login runs an OAuth 2.0 device-code flow against https://api.voyant.travel. It opens a verification page and waits for approval. Use --no-browser to print the URL without opening it.

voyant login
voyant whoami

For CI or another headless environment, create an API token in the dashboard and supply it directly:

voyant login --token tok_live_xyz

Manage the platform

voyant apps list
voyant env set my-app STRIPE_KEY sk_live_xyz --secret
voyant deploy my-app
voyant logs my-app --level error --since 1h
voyant databases list

Every managed command accepts --json for machine-readable output and returns a stable { "error": { "code", "message" } } envelope on failure. Destructive actions require --yes, and commands do not prompt when no TTY is available.

Organizations

API tokens are organization-bound. When you belong to several organizations, select the target explicitly:

voyant org list
voyant org use acme
voyant org current

Override the active organization per command with --org <slug|id> or VOYANT_CLOUD_ORG. The CLI fails instead of guessing when several organizations are available and none is selected.

Credentials

The CLI stores tokens in ~/.voyant/credentials.json with mode 0600, keyed by API URL and organization. It resolves credentials in this order:

--token <value>
VOYANT_CLOUD_API_KEY
The stored credential for the resolved API URL and active organization

Command reference

See every managed command, subcommand, and flag.

​Install

​Log in

​Manage the platform

​Organizations

​Credentials