.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-cluster-agent-token-cache - Manage cached GitLab Agent tokens.


.SH SYNOPSIS
\fBglab cluster agent token-cache  [flags]\fP


.SH DESCRIPTION
Tokens created by \fBglab cluster agent get-token\fR are cached locally
in the system keyring and filesystem to avoid creating new tokens
for each kubectl operation.

.PP
The GitLab CLI caches agent tokens in two locations:
.IP \(bu 2
Keyring: Uses the system keyring (Windows Credential Manager, macOS Keychain, Linux Secret Service).
.IP \(bu 2
Filesystem: Stores tokens in the user's cache directory as encrypted files.

.PP
The cache improves performance by avoiding the need to create new tokens for each kubectl operation when using \fBglab cluster agent update-kubeconfig\fR\&.

.PP
Cached tokens are stored using a key format that includes:
.IP \(bu 2
Base64-encoded GitLab instance URL
.IP \(bu 2
Agent ID

.PP
This ensures tokens are properly isolated by GitLab instance and agent.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.

.PP
\fB-R\fP, \fB--repo\fP=""
	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.


.SH SEE ALSO
\fBglab-cluster-agent(1)\fP, \fBglab-cluster-agent-token-cache-clear(1)\fP, \fBglab-cluster-agent-token-cache-list(1)\fP