Skip to main content

Authentication

note

Seqera Cloud users receive $20 in free credits to get started with Seqera AI. Contact us for additional credits.

Seqera AI uses your Seqera Platform account for authentication. This page describes authentication concepts and step-by-step instructions for managing your sessions.

Authenticating Seqera AI​

Log in​

To authenticate with your Seqera Platform account, run:

seqera login

This will:

  1. Open your default browser to the Seqera login page.

  2. Prompt you to sign in with your Seqera Platform credentials.

  3. Automatically capture the authentication token.

  4. Display a success message in your terminal.

    [Login] Starting Seqera CLI authentication...
    [Login] ✓ Authentication successful!
    [Login] ✓ Organization set: <org_name>

View session status​

To view your current session status, use the /status command inside the TUI:

/status

This shows your authentication status and organization details.

Add access tokens for automation​

For automated environments, you can provide a Seqera Platform access token directly using the SEQERA_ACCESS_TOKEN environment variable:

export SEQERA_ACCESS_TOKEN=<PLATFORM_ACCESS_TOKEN>
seqera ai

When this environment variable is set, the CLI skips the OAuth login flow and uses the provided token directly.

Point a development build at the hosted Seqera AI backend​

If you are testing a development build of the CLI against the hosted production Seqera AI service, set the following environment variables before starting seqera ai.

VariablePurposeExample value
SEQERA_AI_BACKEND_URLSeqera AI backend endpoint used by the CLIhttps://ai-api.seqera.io
SEQERA_AUTH_DOMAINPlatform API base URL used for browser-based loginhttps://cloud.seqera.io/api
SEQERA_AUTH_CLI_CLIENT_IDOAuth client ID for the Seqera AI CLIseqera_ai_cli
TOWER_ACCESS_TOKENPlatform personal access token used instead of browser login<PLATFORM_ACCESS_TOKEN>

Use the OAuth login flow:

export SEQERA_AUTH_DOMAIN=https://cloud.seqera.io/api
export SEQERA_AUTH_CLI_CLIENT_ID=seqera_ai_cli
export SEQERA_AI_BACKEND_URL=https://ai-api.seqera.io
seqera ai

Use a Platform personal access token instead of browser login:

export TOWER_ACCESS_TOKEN=<PLATFORM_ACCESS_TOKEN>
export SEQERA_AI_BACKEND_URL=https://ai-api.seqera.io
seqera ai

You only need SEQERA_AUTH_DOMAIN and SEQERA_AUTH_CLI_CLIENT_ID when using the OAuth login flow.

Log out​

To sign out from the current session, run:

seqera logout

This command revokes your current authentication token and removes locally stored credentials. You will need to re-authenticate on next use.

Organization management​

Seqera AI CLI supports managing your organization selection for billing. Use the seqera org command to view and switch organizations.

View current organization:

seqera org

List all organizations:

seqera org list

Switch organization:

seqera org switch

Clear organization selection:

seqera org clear

Token refresh​

Seqera AI CLI automatically refreshes your authentication token when needed. You are not required to log in again unless:

  • You explicitly log out
  • Your refresh token expires (typically after extended inactivity)
  • Your Seqera Platform account permissions change

Learn more​

On this Page