LinuxCommandLibrary

glab-issue

Manage GitLab issues from the command line

TLDR

Display a specific issue

$ glab issue view [issue_number]
copy

Display a specific issue in the default web browser
$ glab issue view [issue_number] [[-w|--web]]
copy

Create a new issue in the default web browser
$ glab issue create --web
copy

List the last 10 issues with the bug label
$ glab issue list [[-P|--per-page]] [10] [[-l|--label]] "[bug]"
copy

List closed issues made by a specific user
$ glab issue list [[-c|--closed]] --author [username]
copy

Reopen a specific issue
$ glab issue reopen [issue_number]
copy

SYNOPSIS

glab issue [command] [flags]

PARAMETERS

create
    Create a new issue.

list
    List issues.

view
    View an issue.

close
    Close an issue.

reopen
    Reopen an issue.

update
    Update an issue.

--title
    Title for the issue

--description
    Description for the issue

--assignee
    Assignee username(s)

--milestone
    Milestone for the issue

--label
    Label(s) for the issue

--state
    Filter by state (e.g., opened, closed, all)

DESCRIPTION

The `glab issue` command provides a command-line interface to interact with GitLab issues. It allows users to create new issues, list existing issues (potentially filtered), view specific issue details, close/reopen issues, assign issues to users, add comments, and perform other common issue management tasks directly from the terminal.
This is especially helpful for developers who want to quickly manage issues without switching context to a web browser. The command utilizes the GitLab API, so it requires proper authentication with a GitLab instance. `glab issue` enhances developer productivity by streamlining the issue management workflow within the command line environment. Features like issue search using filters are efficient for tracking. In larger project the issue can be easily searched through filters. The command also integrate with Gitlab CI and other devops tools.

CAVEATS

Requires `glab` to be properly configured with a GitLab instance and authenticated user. Some features may depend on the GitLab version and permissions.

AUTHENTICATION

Before using `glab issue`, ensure that you have authenticated with your GitLab instance using `glab auth login`.

ISSUE SEARCH

Utilize the various flags available with `glab issue list` to effectively filter and search for issues based on criteria such as state, assignee, milestone, and labels.

INTERACTIVE ISSUE CREATION

When creating an issue without providing `--title` or `--description` arguments, `glab issue create` may prompt you for the information interactively.

HISTORY

The `glab` CLI tool has evolved to provide enhanced GitLab integration within the command line. The `issue` subcommand was added to streamline issue management directly from the terminal, improving developer workflows.

SEE ALSO

git(1)

Copied to clipboard