---
name: "gt-project-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-project-create"
---

# gt-project-create(1)

Create a project

## NAME

gt-project-create - Create a project

## SYNOPSIS

**gt project create \[\<title\>\] \[flags\]**

## DESCRIPTION

Create a project and print its URL. Without a title on a terminal, a prompt asks for it. A project with the same title, ignoring case, is refused unless --force updates it, since titles address projects.

### JSON FIELDS

```
card_type, closed_issues, created_at, description, id, open_issues, state,
title, type, updated_at, url
```

## OPTIONS

**--card-type**=""\
 	How cards are rendered {text\_only\|images\_and\_text}

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

**-f**, **--force**\[=false\]\
 	Update the project if one with the same title exists

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

**--template**=""\
 	Board template of a new project, creating its columns {none\|basic\_kanban\|bug\_triage}

**-t**, **--title**=""\
 	Project title

## OPTIONS INHERITED FROM PARENT COMMANDS

**--account**\[=false\]\
 	Manage the projects of your account instead of a repository

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

**--cwd**=""\
 	Working **directory** for repository discovery

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

**--org**=""\
 	Manage the projects of an **organization** instead of a repository

**--remote**=""\
 	Git **remote** used for repository discovery

**-R**, **--repo**=""\
 	Select a repository as **OWNER/REPO** or URL

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

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

## EXAMPLE

```
$ gt project create Roadmap --template basic_kanban
$ gt project create --title "Bug triage" --org acme --template bug_triage --description "Incoming bugs"
# Update the project if it exists
$ gt project create Roadmap --description "Planned work" --force
```

## SEE ALSO

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