Skip to content
CLI docs

Login

The login and logout commands manage authentication with Skene Cloud upstream, which is required for pushing engine and trigger artifacts via the push command.

Prerequisites

Basic usage

Log in to upstream:

uvx skene login --upstream https://skene.ai/workspace/my-app

The command prompts you for a token, validates it against the upstream API, and saves the credentials.

Check login status:

uvx skene login --status

Log out:

uvx skene logout

Flag reference

login

FlagShortDescription
--upstream TEXT-uUpstream workspace URL
--status-sShow current login status for this project

logout

No options. Removes saved credentials for the current project.

How credentials are stored

Login saves upstream URL, workspace slug, and API key to .skene.config in the project directory (restrictive permissions 0600). This file is gitignored by default.

Logout removes those fields from the same file, preserving other settings.

Token resolution

When commands need an upstream token, it is resolved in this order:

  1. SKENE_UPSTREAM_API_KEY environment variable
  2. upstream_api_key field in .skene.config

Next steps

  • Push: Push engine and trigger artifacts to upstream
  • Configuration: Config files, env vars, and priority