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?