CLI reference

norcube auth status

Show whether a profile is signed in (exit code 4 when it isn't)

Not verified yet

Shows the selected profile's user, organization, environment, credential store and when its cached access token expires, and asks Norcube Auth whether the stored session still works. SIGNED IN is:

yes              the session works
no               nothing is stored; run `norcube login`
revoked/expired  Norcube Auth ended the session (revoked in the dashboard,
                 signed out elsewhere, or unused for 30 days)
unknown          Norcube Auth couldn't be reached

A cached access token that hasn't expired counts as "yes" without a request: it was minted from the session within the last few minutes. --offline skips the check and only looks at what is stored locally.

Exits with 4 when the profile can't be used ("no" or "revoked/expired"), so scripts can check before they start: norcube auth status >/dev/null || norcube login.

With --all-profiles, lists every profile (checked in parallel) and always exits 0.

Usage

norcube auth status [flags]

Examples

norcube auth status
norcube auth status --all-profiles
norcube auth status --offline
norcube auth status --profile ci || norcube login --profile ci

Flags

FlagDefaultDescription
--all-profilesList every profile
--offlineDon't ask Norcube Auth; only look at the stored credentials

Every command also takes the global flags: --profile, --org, -o, --query, --debug and more.

See also

  • norcube auth: Check the session, manage CLI sessions and CI tokens, and get access tokens for scripts

On this page