.nh
.TH "GH-CODESPACE-CREATE" "1" "Oct 2022" "" "GitHub CLI manual"

.SH NAME
.PP
gh-codespace-create - Create a codespace


.SH SYNOPSIS
.PP
\fB\fCgh codespace create [flags]\fR


.SH OPTIONS
.TP
\fB\fC-b\fR, \fB\fC--branch\fR \fB\fC<string>\fR
repository branch

.TP
\fB\fC--default-permissions\fR
do not prompt to accept additional permissions requested by the codespace

.TP
\fB\fC--devcontainer-path\fR \fB\fC<string>\fR
path to the devcontainer.json file to use when creating codespace

.TP
\fB\fC--idle-timeout\fR \fB\fC<duration>\fR
allowed inactivity before codespace is stopped, e.g. "10m", "1h"

.TP
\fB\fC-l\fR, \fB\fC--location\fR \fB\fC<string>\fR
location: {EastUs|SouthEastAsia|WestEurope|WestUs2} (determined automatically if not provided)

.TP
\fB\fC-m\fR, \fB\fC--machine\fR \fB\fC<string>\fR
hardware specifications for the VM

.TP
\fB\fC-r\fR, \fB\fC--repo\fR \fB\fC<string>\fR
repository name with owner: user/repo

.TP
\fB\fC--retention-period\fR \fB\fC<duration>\fR
allowed time after shutting down before the codespace is automatically deleted (maximum 30 days), e.g. "1h", "72h"

.TP
\fB\fC-s\fR, \fB\fC--status\fR
show status of post-create command and dotfiles


.SH SEE ALSO
.PP
\fB\fCgh-codespace(1)\fR