.nh
.TH "pogo" "1" "Oct 2025" "pogo/dev" "Pogo Manual"

.SH NAME
pogo-token-set - Set or update a personal access token for a server


.SH SYNOPSIS
\fBpogo token set [flags]\fP


.SH DESCRIPTION
Set or update a personal access token for a specific Pogo server.

.PP
The token will be securely stored in your system's keyring/keychain and
automatically used for all future operations with that server.

.PP
If run from within a repository, the server address will be automatically
detected. Otherwise, use the --server flag to specify the server.

.PP
The command will:
- Prompt you to enter the token interactively (for security)
- Validate the token format
- Store it securely in your system keyring
- Confirm successful storage


.SH OPTIONS
\fB-h\fP, \fB--help\fP[=false]
	help for set

.PP
\fB--server\fP=""
	Pogo server address (host:port), defaults to server from current repository


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--time\fP[=false]
	Measure command execution time

.PP
\fB-v\fP, \fB--verbose\fP[=false]
	Enable verbose debug logging


.SH EXAMPLE
.EX
  # Set token for current repository's server (run from within repo)
  pogo token set

  # Set token for a specific server
  pogo token set --server pogo.example.com:8080

  # The command will prompt:
  # Enter the personal access token for pogo.example.com:8080
  # > yMq3CR3BvKR6VrXn7TdDmAtt9N6M3x7a
.EE


.SH SEE ALSO
\fBpogo-token(1)\fP