Skip to main content
Before using the Novita Sandbox CLI, you need to authenticate. The novita-sandbox-cli auth command group manages your login session, active team, and local credentials. Credentials are stored locally at ~/.novita/config.json.

​
Login

Use auth login to sign in to your Novita account. The CLI opens a browser-based authorization page; once you approve, it captures your access token, selects your default team, and writes the credentials to ~/.novita/config.json.
CLI
On success you will see the logged-in email and the selected team:
Output
If you are already logged in, the command reports the current session instead of signing in again. To sign in as a different user, run auth logout first; to switch teams, run auth configure.

​
Logout

Use auth logout to sign out. This deletes the local credential file at ~/.novita/config.json.
CLI
If a session exists, the CLI prints Logged out.; if you are not logged in, it prints Not logged in, nothing to do.

​
Info

Use auth info to show information about the current user, including the logged-in email and the selected team.
CLI
Example output:
Output
If no credentials are found, it prints Not logged in.

​
Configure

Use auth configure to change the active team for an existing session. The CLI fetches the teams you belong to and prompts you to select one; the chosen team’s name, ID, and API key are saved back to ~/.novita/config.json.
CLI
You must be logged in first. If no user config is found, the CLI asks you to run novita-sandbox-cli auth login before configuring a team. After selecting, it confirms the chosen team:
Output
Last modified on August 5, 2026