Sign In — Avora CLI

Authenticate the CLI with your Avora account so it can list workspaces, download workspace graphs, and request generated project archives.

Task

Sign in without placing a password in shell history, confirm access by listing projects, and sign out when the local session should be removed.

Prerequisites

• A valid Avora account.
• Network access to the configured Avora API.
• The correct API base URL when you are not using the default local server.

Find This in Your Terminal

Use the login command without credential flags for interactive prompts:

avora login

Steps

1. Run avora login.

2. Enter your email when prompted.

3. Enter your password when prompted.

4. Confirm the saved session by listing account workspaces.

   avora projects
   

5. When you want to remove the saved authentication session, run:

   avora logout
   

For automation, login also accepts --email and --password, but a password passed on the command line may be recorded in shell history or process listings. Prefer the interactive prompt or a protected automation secret.

Expected Result

A successful login reports the API endpoint and account identity. The CLI stores access and refresh tokens in its local state file. Logout clears the saved authentication object but keeps tracked project records.

Next Step

Continue with List Workspaces or review API & State.

Troubleshooting

• If login returns an HTTP error, verify the email, password, and API base URL.
• If project listing later returns 401, the CLI attempts one refresh using the stored refresh token. Sign in again if refresh fails.
• If the state directory is not writable, set AVORA_CLI_HOME to a writable folder before logging in.