---
name: "gcli-pipelines"
section: "1"
platform: "linux"
package: "gcli"
version: "2.3.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gcli-pipelines"
---

# gcli-pipelines(1)

Inspect and manage GitLab Pipelines

## NAME

**gcli** **pipelines** – Inspect and manage GitLab Pipelines

## SYNOPSIS

**gcli** \[**-n** *n*\] \[**-o** *owner* **-r** *repo*\]

**gcli** **-p** *pipeline-id* \[**-o** *owner* **-r** *repo*\] \[**-n** *n*\]

**gcli** **-j** *job-id* \[**-o** *owner* **-r** *repo*\] *actions...*

## DESCRIPTION

**gcli** is used to display data about the Continuous Integration (CI) service of Gitlab. You can list pipelines of a given repository, list jobs in a given pipeline or perform actions such as restarting jobs or fetching their logs.

## OPTIONS

- **-o**, **--owner** *owner*

  Operate on the repository of the given owner. This option can only be used in combination with **-r**.

- **-r**, **--repo** *repo*

  Operate on the given repository. This option can only be used in combination with **-o**.

- **-n**, **--count** *n*

  Fetch at least *n* items. Setting *n* to -1 will fetch all items. Default: 30. Note that on large repositories fetching all items can take a considerable amount of time and may result in rate limiting by the GitLab API.

- **-p**, **--pipeline** *pipeline-id*

  List jobs in the given pipeline.

- **-j**, **--jobs** *job*

  execute the given *actions* for the specified *job*.

## ACTIONS

*actions...* may be one or more of the following:

- **log**

  Dump the log of the job.

- **status**

  Print a short summary of the job.

- **cancel**

  Cancel the job.

- **retry**

  Retry the job.

- **artifacts** \[**-o** *outfile*\]

  Download the artifacts archive as a zip to disk. The default output file is *artifacts.zip* but it can be overridden by using the **-o** flag.

## EXAMPLES

Print a list of the last 30 pipelines in the current project:

```
$ gcli pipelines
```

List all jobs of pipeline #3316:

```
$ gcli pipelines -p3316
```

Dump the log of Job #423141 in herrhotzenplotz/gcli:

```
$ gcli pipelines -o herrhotzenplotz -r gcli -j 423141 log
```

## SEE ALSO

[git(1)](/git/1.md), [gcli(1)](/gcli/1.md)

## AUTHORS

Nico Sonack aka. herrhotzenplotz ⟨*nsonack@herrhotzenplotz.de*⟩ and contributors.

## BUGS

We are missing a **-a** flag. This is the current implied behaviour.

Please report bugs via E-Mail to *~herrhotzenplotz/gcli-discuss@lists.sr.ht*.

Alternatively you can report them on any of the forges linked at **https://herrhotzenplotz.de/gcli**. However, the preferred and quickest method is to use the mailing list.