kater auth status

It never shows a token. Use it after kater login, or when a command says that Kater rejected your sign-in.

Examples

# Check that you are signed in, and as whom
kater auth status
# Check your sign-in on the Kater API of the prod target
kater auth status --target prod

Options

It also takes the global options --json and --help.

What it shows

• status is authenticated when the API accepts your sign-in.
• user_id is your user id in Kater.
• api_url is the API that it checked, and target is the target that names it.
• credential_source is keychain for the sign-in that kater login saved, or profile for the target’s token.

When your sign-in has expired, the command refreshes it first, and saves the new one.

When the check fails

The command exits with an error that says which of these it is:

• Rejected. The API did not accept your sign-in. Run kater login, or replace the target’s token when you use one.
• Not reachable. The API did not answer. This is not the same as a rejected sign-in, and your saved sign-in does not change. Run kater debug to check the setup.
• Not signed in. You saved no sign-in for this API on this computer. Run kater login.

See also

• kater auth
• All commands