Skip to main content

scout status

Display the authentication status for all configured accounts, including user email and token expiration. The active account is highlighted.

scout status demo

Usage

scout status [flags]

Flags

FlagTypeDefaultDescription
--rawboolfalseOutput JSON
--checkboolfalseVerify the active token with a live API call to the auth server userinfo endpoint

Examples

Check local token status:

scout status

Verify the active token is still valid on the server:

scout status --check

Get status as JSON (useful for scripts):

scout status --raw

Output

The command lists all configured accounts with:

  • Account name
  • User email (extracted from the JWT)
  • Token expiration time
  • Whether the token is expired

The active context is marked with a * prefix.

tip

Use --check to verify the token is still valid on the server. Without it, scout status only reads local token data and checks the expiration claim — the token could have been revoked server-side.

See Also

  • login — authenticate with Scout
  • logout — remove credentials
  • context — manage account contexts
Was this page helpful?