.nh
.TH "GH-AUTH-SETUP-GIT" "1" "Mar 2024" "" "GitHub CLI manual"

.SH NAME
.PP
gh-auth-setup-git - Setup git with GitHub CLI


.SH SYNOPSIS
.PP
\fBgh auth setup-git [flags]\fR


.SH DESCRIPTION
.PP
This command configures \fBgit\fR to use GitHub CLI as a credential helper.
For more information on git credential helpers please reference:
https://git-scm.com/docs/gitcredentials.

.PP
By default, GitHub CLI will be set as the credential helper for all authenticated hosts.
If there is no authenticated hosts the command fails with an error.

.PP
Alternatively, use the \fB--hostname\fR flag to specify a single host to be configured.
If the host is not authenticated with, the command fails with an error.


.SH OPTIONS
.TP
\fB-f\fR, \fB--force\fR \fB<--hostname>\fR
Force setup even if the host is not known. Must be used in conjunction with --hostname

.TP
\fB-h\fR, \fB--hostname\fR \fB<string>\fR
The hostname to configure git for


.SH EXAMPLE
.EX
# Configure git to use GitHub CLI as the credential helper for all authenticated hosts
$ gh auth setup-git

# Configure git to use GitHub CLI as the credential helper for enterprise.internal host
$ gh auth setup-git --hostname enterprise.internal

.EE


.SH SEE ALSO
.PP
\fBgh-auth(1)\fR