.nh
.TH "glab" "1" "Jun 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-ci-run - Create a new CI/CD pipeline.


.SH SYNOPSIS
\fBglab ci run [flags]\fP


.SH DESCRIPTION
Use \fB--branch\fR to specify a branch or reference. Defaults to the current branch.

.PP
The variable flags (\fB--variables\fR, \fB--variables-env\fR,
\fB--variables-file\fR, \fB--variables-from\fR) cannot be used with
\fB--mr\fR\&. If both are used, the command fails.

.PP
Specify one or more pipeline inputs using the \fB-i\fR or \fB--input\fR flag for each
input. Each input flag uses the format \fBkey:value\fR\&.

.PP
The values are typed and will default to \fBstring\fR unless a type is explicitly
specified. To specify a type, use the \fBtype(value)\fR syntax. For example,
\fBkey:string(value)\fR will pass the string \fBvalue\fR as the input.

.PP
Valid types are:
.IP \(bu 2
\fBstring\fR: A string value. This is the default type. For example, \fBkey:string(value)\fR\&.
.IP \(bu 2
\fBint\fR: An integer value. For example, \fBkey:int(42)\fR\&.
.IP \(bu 2
\fBfloat\fR: A floating-point value. For example, \fBkey:float(3.14)\fR\&.
.IP \(bu 2
\fBbool\fR: A boolean value. For example, \fBkey:bool(true)\fR\&.
.IP \(bu 2
\fBarray\fR: An array of strings. For example, \fBkey:array(foo,bar)\fR\&.

.PP
An array of strings can be specified with a trailing comma. For example,
\fBkey:array(foo,bar,)\fR will pass the array \fB[foo, bar]\fR\&. \fBarray()\fR specifies an
empty array. To pass an array with the empty string, use \fBarray(,)\fR\&.

.PP
Value arguments containing parentheses should be escaped from the shell with
quotes. For example, \fB--input key:array(foo,bar)\fR should be written as
\fB--input 'key:array(foo,bar)'\fR\&.


.SH OPTIONS
\fB-b\fP, \fB--branch\fP=""
	Create pipeline on branch or reference \&.

.PP
\fB-i\fP, \fB--input\fP=[]
	Pass inputs to pipeline in format ':\&'. Cannot be used for merge request pipelines. See documentation for examples.

.PP
\fB--mr\fP[=false]
	Run merge request pipeline instead of branch pipeline.

.PP
\fB--variables\fP=[]
	Pass variables to the pipeline in the format :\&. Cannot be used for MR pipelines.

.PP
\fB--variables-env\fP=[]
	Pass variables to the pipeline in the format :\&. Cannot be used for MR pipelines.

.PP
\fB--variables-file\fP=[]
	Pass file contents as a file variable to the pipeline in the format :\&. Cannot be used for MR pipelines.

.PP
\fB-f\fP, \fB--variables-from\fP=""
	JSON file with variables for pipeline execution. Expects array of hashes, each with at least 'key' and 'value'. Cannot be used for MR pipelines.

.PP
\fB-w\fP, \fB--web\fP[=false]
	Open pipeline in a browser. Uses default browser, or browser specified in BROWSER environment variable.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.

.PP
\fB-R\fP, \fB--repo\fP=""
	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.


.SH EXAMPLE
.EX
glab ci run
glab ci run --variables \\"key1:value,with,comma\\"
glab ci run -b main
glab ci run --web
glab ci run --mr

# Specify CI variables
glab ci run -b main --variables-env key1:val1
glab ci run -b main --variables-env key1:val1,key2:val2
glab ci run -b main --variables-env key1:val1 --variables-env key2:val2
glab ci run -b main --variables-file MYKEY:file1 --variables KEY2:some_value

# Specify CI inputs
glab ci run -b main --input key1:val1 --input key2:val2
glab ci run -b main --input "replicas:int(3)" --input "debug:bool(false)" --input "regions:array(us-east,eu-west)"

# Load variables from JSON file
# Create variables.json with this format:
# [
#   {
#     "key": "CI_PIPELINE_SOURCE",
#     "value": "web",
#     "variable_type": "env_var"
#   },
#   {
#     "key": "DEPLOY_ENV",
#     "value": "production"
#   }
# ]
glab ci run -b main --variables-from variables.json
.EE


.SH SEE ALSO
\fBglab-ci(1)\fP