---
name: "glab-auth-status"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-auth-status"
---

# glab-auth-status(1)

View authentication status.

## NAME

glab-auth-status - View authentication status.

## SYNOPSIS

**glab auth status \[flags\]**

## DESCRIPTION

Verifies and displays information about your authentication state.

By default, this command checks the authentication state of the GitLab instance determined by your current context (**git remote**, **GITLAB\_HOST** environment variable, or configuration). To check all configured instances, use **--all**. To check a specific instance, use **--hostname**.

## OPTIONS

**-a**, **--all**\[=false\]\
 	Check the authentication status of all configured instances.

**--hostname**=""\
 	Check the authentication status of a specific instance.

**--jq**=""\
 	Filter JSON output with a jq expression.

**-F**, **--output**="text"\
 	Format output as: text, json.

**-t**, **--show-token**\[=false\]\
 	Display the authentication token.

## OPTIONS INHERITED FROM PARENT COMMANDS

**-h**, **--help**\[=false\]\
 	Show help for this command.

## EXAMPLE

```
# 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
# Print the authentication status of all configured instances as JSON
glab auth status --all --output json
```

## SEE ALSO

**[glab-auth(1)](/glab-auth/1.md)**