Skip to main content
Version: 25.3

Authentication

Seqera AI CLI is in beta

Seqera AI CLI is currently in beta. Features and commands may change as we continue to improve the product.

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.

For Enterprise backend connection settings and development-build examples, see Install Seqera AI.

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