From 5ae0410bd239edfe4c266fa21a1856f2e3b3ef32 Mon Sep 17 00:00:00 2001
From: Benjamin Levesque <14175665+benjlevesque@users.noreply.github.com>
Date: Sat, 13 Sep 2025 22:25:20 +0200
Subject: [PATCH] add examples

---
 pkg/cmd/auth/status/status.go | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/pkg/cmd/auth/status/status.go b/pkg/cmd/auth/status/status.go
index c72dc3341..37f97aaa4 100644
--- a/pkg/cmd/auth/status/status.go
+++ b/pkg/cmd/auth/status/status.go
@@ -137,6 +137,19 @@ func NewCmdStatus(f *cmdutil.Factory, runF func(*StatusOptions) error) *cobra.Co
 
 			To change the active account for a host, see %[1]sgh auth switch%[1]s.
 		`, "`"),
+		Example: heredoc.Doc(`
+			# Show authentication status for all accounts on all hosts
+			$ gh auth status
+
+			# Show authentication status for active accounts on a specific host
+			$ gh auth status --hostname github.example.com --active
+
+			# Show the authentication status with json output 
+			$ gh auth status --json active,token,host,login
+
+			# Gets the access token of the github.com active account
+			$ gh auth status -a --json token --jq '.["github.com"][0].token'
+		`),
 		RunE: func(cmd *cobra.Command, args []string) error {
 			if err := cmdutil.MutuallyExclusive(
 				"`--json` and `--show-token` cannot be used together. To include the token in the JSON output, use `--json token`.",