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

.SH NAME
gt-project-workflow-create - Create a project workflow


.SH SYNOPSIS
\fBgt project workflow create <project> [flags]\fP


.SH DESCRIPTION
Create a workflow that runs on an event and does something to the issue or pull request
it concerns. --event and at least one action are required; the filters narrow which items it
runs for, and Gitea refuses those the event does not support. Columns are given by title or ID,
labels by name or ID.

.SS ARGUMENTS
.EX
A project can be supplied by its title or ID, as in gt project view; --by-name matches a number
as a title only. A workflow is supplied by its ID, which gt project workflow list shows.
.EE

.SS JSON FIELDS
.EX
actions, created_at, enabled, event, filters, id, updated_at
.EE


.SH OPTIONS
\fB--add-label\fP=[]
	Add these label \fBnames\fR to the item

.PP
\fB--column\fP=""
	Move the item to this \fBcolumn\fR, by title or ID

.PP
\fB--disabled\fP[=false]
	Create the workflow disabled

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

.PP
\fB--event\fP=""
	Event that runs the workflow {item_added_to_project|item_removed_from_project|item_reopened|item_closed|item_column_changed|code_changes_requested|code_review_approved|pull_request_merged}

.PP
\fB--from-column\fP=""
	Run only for items moved from this \fBcolumn\fR, by title or ID (event item_column_changed)

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

.PP
\fB--issue-state\fP=""
	Close or reopen the item {close|reopen|none}

.PP
\fB--issue-type\fP=""
	Run only for issues or pull requests {issue|pull_request|any}

.PP
\fB-l\fP, \fB--label\fP=[]
	Run only for items with all of these label \fBnames\fR

.PP
\fB--remove-label\fP=[]
	Remove these label \fBnames\fR from the item

.PP
\fB--to-column\fP=""
	Run only for items moved to this \fBcolumn\fR, by title or ID (event item_column_changed)


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--account\fP[=false]
	Manage the projects of your account instead of a repository

.PP
\fB--by-name\fP[=false]
	Match a numeric project argument as a title rather than an ID

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

.PP
\fB--cwd\fP=""
	Working \fBdirectory\fR for repository discovery

.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--org\fP=""
	Manage the projects of an \fBorganization\fR instead of a repository

.PP
\fB--remote\fP=""
	Git \fBremote\fR used for repository discovery

.PP
\fB-R\fP, \fB--repo\fP=""
	Select a repository as \fBOWNER/REPO\fR or URL

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

.PP
\fB--template\fP=""
	Format JSON output using a Go \fBtemplate\fR; implies --json (see gt help formatting)

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


.SH EXAMPLE
.EX
# move newly added items to the Backlog column
$ gt project workflow create Roadmap --event item_added_to_project --column Backlog
# move merged pull requests to Done and label them
$ gt project workflow create Roadmap --event pull_request_merged --column Done --add-label merged
# react to items moved from Doing to Done
$ gt project workflow create 3 --org acme --event item_column_changed --from-column Doing --to-column Done --issue-state close
.EE


.SH SEE ALSO
\fBgt-project-workflow(1)\fP