Skip to main content
Version: 26.1

Installation

The Seqera CLI runs in your terminal on macOS, Linux, or Windows (via WSL). It connects to Seqera Platform and to the Co-Scientist backend in your Enterprise deployment so you can build, run, and debug Nextflow pipelines from a single interactive session.

This page covers how to install, update, and uninstall the CLI with npm, how to switch to a development build, and how to point the CLI at the Co-Scientist backend. Once the CLI is on your PATH, see the Quickstart to log in and start your first session.

Prerequisites

You will need the following to get started:

  • Node.js 18 or later
  • macOS, Linux, or Windows with WSL
  • A user account on your Seqera Platform Enterprise deployment
  • Network access to the Co-Scientist backend

Install the CLI​

Once Platform is installed with agent-backend and portal-web enabled, use the install endpoint to install the CLI:

curl -fsSL https://<global.portalWebDomain>/install | bash
curl -fsSL https://ai.platform.example.com/install | bash

Then confirm the CLI is on your PATH:

seqera --version

Install a development build​

To install the latest pre-release, use the development channel:

curl -fsSL https://ai.platform.example.com/install | bash -s -- --channel dev

Update the CLI​

To update the CLI, run the install endpoint again. The install script updates the CLI in place:

curl -fsSL https://ai.platform.example.com/install | bash

If you use Co-Scientist as a skill for a coding agent, sync your installed skills with the new CLI version after upgrading:

seqera skill check --update

This scans both local and global installations by default. Pass --global or --local to narrow the scope.

Uninstall the CLI​

To remove the CLI from your system, run:

rm ~/.config/seqera-ai/*
rm ~/.seqera/bin/seqera

Configure the Co-Scientist backend​

To configure the Co-Scientist backend, set the backend URL before starting Co-Scientist:

export SEQERA_AI_BACKEND_URL=https://ai-api.platform.example.com

If your Enterprise deployment uses Platform OIDC, also set the OIDC authority base URL:

export SEQERA_AUTH_DOMAIN=https://platform.example.com/api

The CLI fetches OpenID configuration from this URL and opens the discovered authorization endpoint in your browser. See Authentication for the complete environment variable reference and OAuth versus token-based examples.

Learn more​

On this Page