---
name: "gt-repo-create"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-repo-create"
---

# gt-repo-create(1)

Create a repository

## NAME

gt-repo-create - Create a repository

## SYNOPSIS

**gt repo create \[\<name\>\] \[flags\]**

## 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.

\--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.

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.

### JSON FIELDS

```
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
```

## OPTIONS

**--as-template**\[=false\]\
 	Make the new repository a template

**--auto-init**\[=false\]\
 	Add a first commit with a README

**--clone**\[=false\]\
 	Clone the new repository into the current directory

**--copy-avatar**\[=true\]\
 	Copy the template's avatar

**--copy-content**\[=true\]\
 	Copy the template's Git content

**--copy-git-hooks**\[=true\]\
 	Copy the template's Git hooks

**--copy-labels**\[=true\]\
 	Copy the template's labels

**--copy-topics**\[=true\]\
 	Copy the template's topics

**--copy-webhooks**\[=false\]\
 	Copy the template's webhooks

**--default-branch**=""\
 	Name of the default branch

**-d**, **--description**=""\
 	Repository description

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

**-h**, **--help**\[=false\]\
 	help for create

**--label-template**=""\
 	Add the labels of this label set

**-l**, **--license**=""\
 	License template (requires --auto-init)

**--object-format**=""\
 	Git object format {sha1\|sha256}

**--org**=""\
 	Create the repository in this organization

**--private**\[=false\]\
 	Make the repository private

**--public**\[=false\]\
 	Make the repository public (the default)

**--push**\[=false\]\
 	Push the current branch of --source

**--readme**=""\
 	README template (requires --auto-init)

**--remote-name**="origin"\
 	Name of the new repository's remote in --source

**--source**=""\
 	Publish the local Git repository in this directory

**--team**=""\
 	Grant this organization team access

**--template**=""\
 	Copy this template repository (OWNER/REPO or URL)

**--trust-model**=""\
 	Signature trust model {default\|collaborator\|committer\|collaboratorcommitter}

## OPTIONS INHERITED FROM PARENT COMMANDS

**--csv**\[=""\]\
 	Output CSV with the specified comma-separated **fields**, or all fields

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

**--host**=""\
 	Gitea instance **URL**, including any base path

**--interactive**\[=false\]\
 	Allow prompts with machine output

**-q**, **--jq**=""\
 	Filter JSON output using a jq **expression**; implies --json

**--json**\[=""\]\
 	Output JSON with the specified comma-separated **fields**, or all fields

**--no-input**\[=false\]\
 	Disable prompts and implicit editor/browser interactions

**--sudo**=""\
 	Perform API requests as this **user** (requires an administrator account)

**--user**=""\
 	Account **name** on the selected instance

## EXAMPLE

```
# 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
```

## SEE ALSO

**[gt-repo(1)](/man/gt-repo/1.md)**