.nh
.TH "GT-REPO-CREATE" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

.SH NAME
gt-repo-create - Create a repository


.SH SYNOPSIS
\fBgt repo create [<name>] [flags]\fP


.SH DESCRIPTION
Create a repository for your account, or for an organization as ORG/NAME or with --org. Site
administrators can also create one for another user as USER/NAME.

.PP
--auto-init adds a first commit with a README, .gitignore and license; --template copies another
repository. --source adds the new repository as a remote of a local Git repository, creating it
with the same object format, and --push pushes its current branch there.

.PP
On a terminal, without a name or flags, it asks for the owner, name, description and visibility,
whether to add a README with a license and .gitignore templates, and whether to clone the new
repository.

.SS JSON FIELDS
.EX
actions_enabled, archived, clone_url, default_branch, description, empty,
fork, forks_count, full_name, id, mirror, mirror_interval, name,
open_issues_count, open_pr_count, original_url, parent, private, ssh_url,
stars_count, template, topics, updated_at, url, website
.EE


.SH OPTIONS
\fB--as-template\fP[=false]
	Make the new repository a template

.PP
\fB--auto-init\fP[=false]
	Add a first commit with a README

.PP
\fB--clone\fP[=false]
	Clone the new repository into the current directory

.PP
\fB--copy-avatar\fP[=true]
	Copy the template's avatar

.PP
\fB--copy-content\fP[=true]
	Copy the template's Git content

.PP
\fB--copy-git-hooks\fP[=true]
	Copy the template's Git hooks

.PP
\fB--copy-labels\fP[=true]
	Copy the template's labels

.PP
\fB--copy-topics\fP[=true]
	Copy the template's topics

.PP
\fB--copy-webhooks\fP[=false]
	Copy the template's webhooks

.PP
\fB--default-branch\fP=""
	Name of the default branch

.PP
\fB-d\fP, \fB--description\fP=""
	Repository description

.PP
\fB--dry-run\fP[=false]
	Show the write requests gt would send, without sending them

.PP
\fB-g\fP, \fB--gitignores\fP=""
	Comma-separated .gitignore templates (requires --auto-init)

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for create

.PP
\fB--label-template\fP=""
	Add the labels of this label set

.PP
\fB-l\fP, \fB--license\fP=""
	License template (requires --auto-init)

.PP
\fB--object-format\fP=""
	Git object format {sha1|sha256}

.PP
\fB--org\fP=""
	Create the repository in this organization

.PP
\fB--private\fP[=false]
	Make the repository private

.PP
\fB--public\fP[=false]
	Make the repository public (the default)

.PP
\fB--push\fP[=false]
	Push the current branch of --source

.PP
\fB--readme\fP=""
	README template (requires --auto-init)

.PP
\fB--remote-name\fP="origin"
	Name of the new repository's remote in --source

.PP
\fB--source\fP=""
	Publish the local Git repository in this directory

.PP
\fB--team\fP=""
	Grant this organization team access

.PP
\fB--template\fP=""
	Copy this template repository (OWNER/REPO or URL)

.PP
\fB--trust-model\fP=""
	Signature trust model {default|collaborator|committer|collaboratorcommitter}


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--csv\fP[=""]
	Output CSV with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--debug\fP[=false]
	Log the method, URL, status, and duration of each HTTP request to stderr

.PP
\fB--host\fP=""
	Gitea instance \fBURL\fR, including any base path

.PP
\fB--interactive\fP[=false]
	Allow prompts with machine output

.PP
\fB-q\fP, \fB--jq\fP=""
	Filter JSON output using a jq \fBexpression\fR; implies --json

.PP
\fB--json\fP[=""]
	Output JSON with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--no-input\fP[=false]
	Disable prompts and implicit editor/browser interactions

.PP
\fB--sudo\fP=""
	Perform API requests as this \fBuser\fR (requires an administrator account)

.PP
\fB--user\fP=""
	Account \fBname\fR on the selected instance


.SH EXAMPLE
.EX
# Create a private repository with a README and an MIT license
$ gt repo create project --private --auto-init --license MIT

# Create a repository in an organization from a template
$ gt repo create acme/service --template acme/service-template

# Publish the local repository in the current directory
$ gt repo create project --source . --push
.EE


.SH SEE ALSO
\fBgt-repo(1)\fP