⌘K

vtrix auth

Manage authentication with your vtrix.ai account.

Subcommands

CommandDescription
vtrix auth loginInitiate device code authorization; credentials are saved automatically on completion
vtrix auth set-key <api-key>Set an API Key directly, no browser login required
vtrix auth statusShow current login status and account info
vtrix auth logoutClear local credentials

Login flow

1

Initiate login

vtrix auth login

The terminal outputs a device code and authorization URL:

┌─────────────────────────────────────────────┐
│                                             │
│   Visit: https://vtrix.ai/device           │
│   Code:  ABCD-1234                         │
│                                             │
└─────────────────────────────────────────────┘

Waiting for authorization... (opens browser automatically)
2

Complete authorization in the browser

The CLI will automatically try to open your browser. If it doesn’t open, visit the URL above manually, enter the device code, and confirm.

3

Authorization successful

Once confirmed in the browser, the terminal receives the response automatically:

✓ Authenticated as user@example.com
✓ Credentials saved to keychain

Subsequent commands like vtrix run and vtrix models will not require re-authentication.

set-key: Set API Key directly

Ideal for automation scripts, CI environments, or when you already have an API Key and want to skip the browser flow.

vtrix auth set-key <api-key>
✓ API Key updated

set-key only updates the API Key field in the local config and does not affect existing AuthToken or RefreshToken values.

When to use set-key vs login
  • Have an API Key: use set-key — writes directly, no browser needed.
  • First time / need full account credentials: use login — completes device code authorization and obtains both Token and API Key.

Credential storage

PlatformLocation
macOS / WindowsSystem Keychain
Linux (with D-Bus)System Keychain
Linux (without D-Bus)~/.config/vtrix/config.yml
Force file-based storage

Set the environment variable VTRIX_NO_KEYCHAIN=1 to skip the Keychain. Credentials will always be written to ~/.config/vtrix/config.yml.

Check current status

vtrix auth status
● Logged in
  User:    user@example.com
  Expires: 2026-07-10

Log out

vtrix auth logout
✓ Credentials cleared