GCLI-ISSUES(1)

NAME
gcli issues - Manage issues in various git forges

SYNOPSIS
gcli [-n n] [-a] [-s] [-A author] [-L label] [-M milestone] [-o owner -r repo] [search-query]
gcli -i issue [-o owner -r repo] actions...
gcli create [-o owner -r repo] [-y]

DESCRIPTION
Use gcli to search, list, create, edit or delete issues in repositories in various git(1) forges such as GitHub, GitLab and Gitea. Without any action specified, gcli will list issues in the given or autodetected repository.

OPTIONS

-s, --sorted
    Reverse the output such that most recent items appear at the bottom.

-o, --owner owner
    List issues in the repository of the given owner. This option can only be used in combination with -r.

-r, --repo repo
    List issues in the given repository. This option can only be used in combination with -o.

-a  List issues disregarding their state. This will list closed issues as well. Cannot be combined with actions. This does not affect the -n option.

-A, --author user
    Only list issues authored by the given user.

-L, --label label
    Filter issues by the given label. This option may only be specfied once.

-M, --milestone milestone
    Filter issues by the given milestone. This option may only be specfied once.

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

-i, --id issue
    execute the given actions for the specified issue.

SUBCOMMANDS

create
    Create a new issue in the given or autodetected repository. The editor will come up and ask you to enter an issue message.

    The following flags can be specified:

    -i, --in owner/repo
        Specify in which repository the issue is to be created.

    -y, --yes
        Do not ask for confirmation before creating the issue. Assume yes.

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

all Display both a summary and the original post of the issue.

comments
    Print a list of comments under the issue.

status
    Print a short summary of the issue.

op  Print the original post of the issue.

close
    Close the issue.

reopen
    Reopen a closed issue.

assign assignee
    Assign the issue to the given assignee (user name).

labels [options]
    The following options can be specified more than once:

    add label
        Add the given label to the issue.

    remove label
        Remove the given label from the issue.

milestone id
    Assign the issue to a milestone with the given id.

milestone -d
    Clear associated milestone of the given issue.

notes
    Alias for the comments action that prints the list of comments associated with the issue.

title new-title
    Change the title of the issue to new-title.

attachments
    List bug attachments. This action is only available on Bugzilla.

EXAMPLES
Print a list of issues in the current project:

    $ gcli issues

Search for issues containing “crash” in contour-terminal/contour on GitHub including closed issues:

    $ gcli -t github issues -o contour-terminal -r contour -a crash

Report a new issue in the current project:

    $ gcli issues create "summary here"

Print both a summary and comments of issue 1 in herrhotzenplotz/gcli:

    $ gcli issues -o herrhotzenplotz -r gcli -i 1 status comments

Add the labels ‘foo’ and ‘bar’ to the issue with id 420:

    $ gcli issues -i420 labels add foo add bar

List issues with the label “bug”:

    $ gcli issues -L bug

SEE ALSO
git(1), gcli(1)

AUTHORS
Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contributors.

CAVEATS
GitHub and Gitea treat Pull Requests as Issues. Due to the semantics of gcli those issues that are actually PRs are dropped from the output. In this case a note will be printed indicating how many issues were dropped. You can suppress this warning using the -q program option.

BUGS
GitHub only supports removing labels from issues one by one. If you still want to remove multiple issues with a single gcli call, you may do something like:

    $ gcli issues -i42 \
            labels remove bug \
            labels remove foo

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.