Cross platform GitLab CLI tool
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

GitLabCLI

Build status codecov

What is GitLabCLI ?

  • It's a cross platform GitLab command line tool to quickly & naturally perform frequent tasks on GitLab project.
  • It does not force you to hand craft json or use other unnatural ways (for example ids, concatenating of strings) like other CLI's to interact with GitLab.
  • It does not have any dependencies.
  • It's self contained .NET core application - you don't need to have .NET installed for it to work.

Quick start

1. Configure how to authenticate with GitLab API:

To authenticate using username & password:

gitlab config --host "https://gitlab-host.com" --username "your username" --password "your password"

To authenticate using token:

gitlab config --host "https://gitlab-host.com" --token "your token"

To boost your productivity it's recommended to set default project also. So you will not need to specify it everytime.

gitlab config --default-project "defaultproject"

More configuration options can be found here

2. If you want to find more information about certain commands just use --help:

For example:

gitlab --help
gitlab config --help
gitlab issue create --help

or see Wiki:
Creating and listing issues
Creating and listing merge requests

Some examples:

All commands have both short & long syntax.

Issues

# create issue:
gitlab issue create -t "Issue title" -d "Issue description" -l label1,label2

# or long syntax:
gitlab issue create --title "Issue title" --description "Issue description" --labels label1,label2

# create issue for specific user:
gitlab issue create -t "Issue title" -a User

# create issue for yourself:
gitlab issue create -t "Issue title --assign-myself

# create issue in differentproject (not default):
gitlab issue create -t "Issue title" -p differentproject

# close issue 101:
gitlab issue close --id 101

# list issues assigned to me:
gitlab issue list --assigned-to-me

# list issues assigned to User & filtered by label:
gitlab issue list --assignee User -l label1

# list issues having bug in title or description:
gitlab issue list --filter bug

# list issues with ids 101 and 202:
gitlab issue list --id 101,202

# open issue 101 with the default browser:
gitlab issue browse --id 101

Merge requests

# create merge request feature -> develop:
gitlab merge create -t "Merge request title" -s feature -d develop

# create merge request feature -> develop with assignee User:
gitlab merge create -t "Merge request title" -s feature -d develop -a User

# list merge requests:
gitlab merge list # list opened
gitlab merge list opened # list opened
gitlab merge list merged # list merged
gitlab merge list closed # list closed
gitlab merge list all # list all

# list merge requests for assignees:
gitlab merge list -a "User" # assigned to user
gitlab merge list --assigned-to-me