Configuration

GitLab CLI supports lots of options to boost your productivity.

Options are persisted here:
Windows: %LOCALAPPDATA%\gitlab\appsettings.json
Unix: $HOME/.local/share/appsettings.json

It's required to specify username & password or token for GitLabCLI to authorize you with GitLab.

  -s, --show                      Shows current configuration.

  -h, --host                      GitLab host url.

  -t, --token                     Authentication token of GitLab host.

  -u, --username                  GitLab username. Not required if Token specified.

  -p, --password                  GitLab user password. Not required if Token specified.

  -d, --default-project           Default GitLab project name. Used for issues and merges.

  -i, --default-issues-project    Default GitLab issue label. Used when creating & listing issues. This option
                                  overrides default-project for issues.

  -m, --default-merges-project    Default GitLab project name. Used for merges. This option overrides default-project
                                  for merges.

  -l, --default-issues-label      Default GitLab issue labels. Used when creating & listing issues.

  --help                          Display this help screen.

  --version                       Display version information.

gitlab configuration options can be using simple syntax:
gitlab --key value

For example:
gitlab --default-project YourDefaultProject

To see available options you can also just run gitlab config --help.