From 5bb76e832b835eadd2ae7e46a65004522be6b181 Mon Sep 17 00:00:00 2001
From: Benjamin Levesque <14175665+benjlevesque@users.noreply.github.com>
Date: Tue, 16 Sep 2025 22:00:07 +0200
Subject: [PATCH] examples

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

diff --git a/pkg/cmd/auth/status/status.go b/pkg/cmd/auth/status/status.go
index 2acdb1687..520116bcb 100644
--- a/pkg/cmd/auth/status/status.go
+++ b/pkg/cmd/auth/status/status.go
@@ -136,17 +136,23 @@ 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
+			# Display 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
+			# Display authentication status for the active account on a specific host
+			$ gh auth status --active --hostname github.example.com
 
-			# Show the authentication status with json output 
-			$ gh auth status --json active,token,host,login
+            # Display tokens in plain text
+			$ gh auth status --show-token
 
-			# Gets the access token of the github.com active account
-			$ gh auth status -a --json token --jq '.["github.com"][0].token'
+			# Format authentication status as JSON
+			$ gh auth status --json active,login,host
+
+			# Include plain text token in JSON output
+			$ gh auth status --json token,login
+
+			# Format output as a flat JSON array
+			$ gh auth status --json active,host,login --jq add
 		`),
 		RunE: func(cmd *cobra.Command, args []string) error {
 			if err := cmdutil.MutuallyExclusive(