Skip to main content

atmos auth whoami

Display the current authentication context, including the effective identity and associated credentials. Useful for verifying which account is active and troubleshooting identity or session issues.

atmos auth whoami --help

Usage​

atmos auth whoami [--identity <name>] [--output json]

Examples​

# Show current identity (human-friendly)
atmos auth whoami

# Interactively select identity to inspect
atmos auth whoami --identity

# Show a specific identity
atmos auth whoami --identity dev-admin

# Use short form of identity flag
atmos auth whoami -i dev-admin

# Interactive selection with short form
atmos auth whoami -i

# JSON output (redacts home directory from paths)
atmos auth whoami --output json

Arguments​

n/a
No positional arguments.

Flags​

--identity (alias -i)

Specify the target identity to inspect. This flag has three modes:

  • With value (--identity admin): Use the specified identity
  • Without value (--identity): Show interactive selector to choose identity
  • Omitted: Use the default identity configured in atmos.yaml, or prompt if no default is set

Environment variables: ATMOS_IDENTITY or IDENTITY (checked in that order)

--output (alias -o)
Output format. Supported: json. Default is human-readable.

Environment variables​

ATMOS_IDENTITY
Default identity when --identity is not provided.
ATMOS_AUTH_WHOAMI_OUTPUT
Set to json for JSON output by default.