CLI Menu

Command Line Interface (CLI) CLI QuickStart GuideCommand Line Interface (CLI) ExamplesUsing the CLI with High Assurance Resources


globus whoami - Show the currently logged-in identity.


globus whoami ['OPTIONS']


The globus whoami command will display information for the currently logged-in user.



Show the full identity set of the currently logged in identity, which contains the primary identity and any identities linked to it.

-F, --format '[json|text|unix]'

Set the output format for stdout. Defaults to "text".

TEXT output is human-friendly textual output, usually in table or record-oriented format. In some cases, TEXT format is intentionally kept simple to support naive use of commands within a subshell, but it is not generally guaranteed to be parseable.

JSON output will produce raw JSON data from underlying Globus services. This data is useful for using the CLI as part of a programmatic process, or for deciding on valid --jmespath queries.

UNIX output will produce a line-by-line serialization of the result data (which would be visible with JSON). This is very suitable for use in pipelines with grep, sort, and other standard unix tools.

Whenever you request --format=UNIX, you should also be using a --jmespath query to select the exact fields that you want. This better guarantees the consistency of output contents and ordering.

-h, --help

Show help text for this command.

-v, --verbose

Control the level of output.

Use -v or --verbose to show warnings and any additional text output.

Use -vv to add informative logging.

Use -vvv to add debug logging and full stack on any errors. (equivalent to -v --debug)


Note: this output is not affected by sessions in any way. For information on which of your identities are in session use globus session show

If no options are given the default output is just the preferred username of the logged in identity.

If --linked-identities is given the output will be each username in the logged-in user’s identity set.

If --verbose is given, the following fields will be output, either in a record format or a table format if --linked-identities is also given.

  • 'Username'

  • 'Name'

  • 'ID'

  • 'Email'


Display multiple fields of the current user’s information:

$ globus whoami -v

Display each username in the current user’s identity set:

$ globus whoami --linked-identities


0 on success.

1 if a network or server error occurred.

2 if the command was used improperly.

© 2010- The University of Chicago Legal