Skip to main content

remote

This section contains the Git remote related configuration options.

You can configure a remote for GitHub, GitLab or Bitbucket as follows:

[remote.github]
owner = "orhun"
repo = "git-cliff"
token = ""

Change this to remote.gitlab or remote.bitbucket accordingly to your project.

owner

Sets the owner (username) of the Git remote.

repo

Sets the name of the repository.

If you are using GitHub, you can use the --github-repo argument or GITHUB_REPO environment variable.

e.g.

git cliff --github-repo orhun/git-cliff

Same applies for GitLab/Bitbucket with --gitlab-repo/--bitbucket-repo and GITLAB_REPO/BITBUCKET_REPO environment variables.

token

Sets the access token for the remote.

If you are using GitHub, then you can also pass this value via --github-token argument or GITHUB_TOKEN environment variable as follows:

git cliff --github-token <TOKEN>

Same applies for GitLab/Bitbucket with --gitlab-token/--bitbucket-token and GITLAB_TOKEN/BITBUCKET_TOKEN environment variables.