.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-auth-status - View authentication status.


.SH SYNOPSIS
\fBglab auth status [flags]\fP


.SH DESCRIPTION
Verifies and displays information about your authentication state.

.PP
By default, this command checks the authentication state of the GitLab instance
determined by your current context (\fBgit remote\fR, \fBGITLAB_HOST\fR environment variable,
or configuration). To check all configured instances, use \fB--all\fR\&.
To check a specific instance, use \fB--hostname\fR\&.


.SH OPTIONS
\fB-a\fP, \fB--all\fP[=false]
	Check the authentication status of all configured instances.

.PP
\fB--hostname\fP=""
	Check the authentication status of a specific instance.

.PP
\fB-t\fP, \fB--show-token\fP[=false]
	Display the authentication token.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH EXAMPLE
.EX
# Check authentication status for the instance in your current context
glab auth status

# Check authentication status for all configured instances
glab auth status --all

# Check authentication status for a specific instance
glab auth status --hostname gitlab.example.com

# Display the authentication token alongside the status
glab auth status --show-token

.EE


.SH SEE ALSO
\fBglab-auth(1)\fP