Get started
Co-Scientist is an interactive CLI for building, running, and debugging Nextflow pipelines on Seqera Platform.
This page covers how to log in, start a session, switch between build mode and plan mode, debug a Platform run with a built-in skill, and set a long-running goal.
You will need the following to get started:
- Co-Scientist CLI
- A Seqera Platform account (sign up for free)
Quickstart
-
Log in to Seqera Platform:
seqera loginThe CLI opens a browser window. After you authorize, the terminal confirms the login and stores a session token locally. For headless environments, token-based login, or session management, see Authentication.
-
Start an interactive session:
seqera aiThe Co-Scientist prompt appears, with a footer showing the active mode (build by default).
-
List the available commands and skills:
/helpType
/to open command autocomplete. -
Switch between build and plan modes:
- Build mode (default): Executes commands, edits files, and launches workflows
- Plan mode: Read-only analysis and planning, for exploring options before making changes
Press
Shift+Tabto switch between modes. The active mode appears in the composer footer, and/statusprints a full readout.Try plan mode with a comparison prompt:
Compare whether I should add FastQC or fastp as the first QC step in this RNA-seq pipeline, including the workflow changes each option would require -
Debug a Seqera Platform run with a built-in skill:
/debug-last-run-on-seqeraCo-Scientist fetches your most recent workspace run, inspects logs and exit codes, and walks through likely causes and fixes. You need at least one workflow run in the workspace for this skill to find something to debug.
-
Set a long-running goal:
/goal update this pipeline for AWS Batch and add nf-testsCo-Scientist works across model turns until the goal completes or the attempt limit is reached. See Use cases for more example prompts.