feat: add bk auth token command (#736)

Author: mcncl

cmd/auth/token.go

@@ -0,0 +1,44 @@
+package auth
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/alecthomas/kong"
+	"github.com/buildkite/cli/v3/internal/cli"
+	"github.com/buildkite/cli/v3/pkg/cmd/factory"
+)
+
+type TokenCmd struct{}
+
+func (c *TokenCmd) Help() string {
+	return `
+Prints the stored API token for the currently selected organization to stdout.
+
+The token is retrieved from the system keychain (or the BUILDKITE_API_TOKEN
+environment variable if set). This is useful for passing the token to other
+tools, for example:
+
+Examples:
+	# Print the current token
+	$ bk auth token
+
+	# Use the token in a curl request
+	$ curl -H "Authorization: Bearer $(bk auth token)" https://api.buildkite.com/v2/user
+`
+}
+
+func (c *TokenCmd) Run(kongCtx *kong.Context, globals cli.GlobalFlags) error {
+	f, err := factory.New(factory.WithDebug(globals.EnableDebug()))
+	if err != nil {
+		return err
+	}
+
+	token := f.Config.APIToken()
+	if token == "" {
+		return fmt.Errorf("no token found; run `bk auth login` to authenticate")
+	}
+
+	fmt.Fprintln(os.Stdout, token)
+	return nil
+}

main.go

@@ -71,6 +71,7 @@ type (
 		Logout auth.LogoutCmd `cmd:"" help:"Logout and remove stored credentials"`
 		Status auth.StatusCmd `cmd:"" help:"Print the current user auth status"`
 		Switch auth.SwitchCmd `cmd:"" help:"Switch to a different organization" aliases:"use"`
+		Token  auth.TokenCmd  `cmd:"" help:"Print the stored API token for the current organization"`
 	}
 	AgentCmd struct {
 		Install agent.InstallCmd `cmd:"" help:"Install the buildkite-agent binary locally."`