crab auth

Manage cached authentication state for a configured Crab service.

Synopsis

crab auth <SUBCOMMAND>

crab auth status
crab auth refresh

Use crab login and crab logout to establish or clear the cached login session.

Inspect before refreshing

crab auth status reads the locally configured authentication state and shows whether Crab has a usable cached session. It is the appropriate first command when a managed or authenticated storage operation fails. Status inspection does not establish a new login.

Use refresh when a cached refresh credential exists but the current access token needs replacement:

crab auth status
crab auth refresh
crab auth status

The final status check verifies the new local state. Refresh can still fail if the identity-provider session was revoked, the configured service is unreachable, or the refresh credential expired. In those cases, use crab login to create a new session. Use crab logout when you intend to remove cached credentials rather than repair them. For scripts, inspect the subcommand help for structured-output support instead of parsing terminal text.