Skip to main content
Validating a .vio file works offline with no account. Everything that talks to Viorant Cloud — deploying, listing, logs, schedules — needs you to sign in.

​
Sign in

From the shell:
Or from your terminal:
In an interactive terminal, vio login shows a picker: Google, GitHub, or Email. Choose one method, or pass its flag to skip the picker:
The shell accepts the same flags: /login --github, for example. Pass only one of --google, --github, or --email. Google and GitHub open your browser to sign in. GitHub needs a verified email address. Without an interactive terminal, bare vio login uses Google without a picker. Browser approval still needs you.

​
Sign in with email

Email sign-in needs an existing Viorant account. To create an account with email, use Sentinel and confirm your email first.
  1. Run vio login --email in an interactive terminal.
  2. At Email:, enter your address.
  3. At Password:, enter your password.
  4. Complete the quick check in the browser that opens.
  5. Return to your terminal for the Signed in as message and credit balance.
Password characters do not appear in the terminal. In the shell, /login --email shows a masked password field. Password entry stays out of command history and saved conversations.
Enter the password only at the password prompt. Never put it in a command, environment variable, file, or message to an AI agent.
Press Ctrl+C to cancel. In the shell, Esc also cancels sign-in. vio prints the browser link. If the browser does not open, open the link yourself. To print the link without a browser launch, add --no-browser:
For email, enter your email and password first. Then open the printed browser-check link.
Sign in on the same machine that runs vio. The sign-in hands back to a local address on that machine, so a browser on another computer can’t complete it.
--no-browser does not skip browser approval or make email sign-in work without a terminal. The shell also accepts it, for example /login --email --no-browser.

​
If sign-in fails

If your CLI does not recognize a sign-in flag, update it.

​
Check who you are

In the shell, /whoami and /status. As subcommands:
Both take --json for scripts. Signed out, they exit with code 3.

​
Your plan

In the shell:
Or as a subcommand:
vio upgrade shows the plan you are on and the link to sentinel.viorant.io/plans, where you change it — and at an interactive terminal it opens that page for you. The purchase happens there, never in the terminal. Signed out, it still prints the link. vio upgrade --json prints {"plan": …, "url": …} and never opens a browser.
vio upgrade changes your plan, not the app. To update vio itself, run vio update — see Install the CLI.

​
Where credentials live

vio keeps one file, ~/.viorant/auth.json, readable only by you (0600). It stores your session and refreshes it automatically. Provider keys and connector tokens are never written there.

​
Sign out

From the shell, /logout. As a subcommand:
This clears the credentials on this machine only, and works offline.