git-cliff(1)                General Commands Manual               git-cliff(1)

<?><?><?> (NAME)
       git-cliff - <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> (changelog)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       git-cliff [-h|--help] [-V|--version] [-v|--verbose]... [-i|--init]
       [--templates-dir] [--list-templates] [-c|--config] [--config-url]
       [-w|--workdir] [-r|--repository] [--include-path] [--exclude-path]
       [--tag-pattern] [--with-commit] [--with-tag-message] [--skip-tags]
       [--ignore-tags] [--count-tags] [--limit-tags] [--skip-commit]
       [-p|--prepend] [-o|--output] [-t|--tag] [--bump] [--bumped-version]
       [-b|--body] [--body-file] [-l|--latest] [--current] [-u|--unreleased]
       [--topo-order] [--use-branch-tags] [--no-exec] [-x|--context]
       [--from-context] [-s|--strip] [--sort] [--github-token] [--github-repo]
       [--gitlab-token] [--gitlab-repo] [--gitea-token] [--gitea-repo]
       [--bitbucket-token] [--bitbucket-repo] [--http-timeout]
       [--use-native-tls] [--offline] [RANGE]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> (changelog) <?><?>
       <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?> (FLAGS)
       -h, --help
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>

       -V, --version
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>

       -v, --verbose
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>

       --list-templates
              <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> (<?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>)

       --bumped-version
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>

       -l, --latest
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> (tag)

       --current
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?>

       -u, --unreleased
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>

       --topo-order
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?>

       --use-branch-tags
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>

       --no-exec
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?>

       -x, --context
              <?><?><?> <?><?><?><?><?><?> (context) <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> JSON

       --use-native-tls
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> TLS <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>

<?><?><?><?><?><?><?><?> (OPTIONS)
       -i, --init [<CONFIG>]
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> cliff.toml

       --templates-dir <PATH>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              `--init`.

       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_TEMPLATES_DIR
              <?><?><?><?> <?><?><?>.

       -c, --config <PATH>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.

       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?> <?><?>
       <?><?><?><?><?> `cliff.toml` / `.cliff.toml` / `.config/cliff.toml` <?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?>)<?> <?> <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_CONFIG <?><?><?><?>
              <?><?><?>.

       --config-url <URL>
              <?><?><?><?><?> URL <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_CONFIG_URL
              <?><?><?><?> <?><?><?>.

       -w, --workdir <PATH>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_WORKDIR <?><?><?><?>
              <?><?><?>.

       -r, --repository <PATH>...
              <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_REPOSITORY
              <?><?><?><?> <?><?><?>.

       --include-path <PATTERN>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_INCLUDE_PATH
              <?><?><?><?> <?><?><?>.

       --exclude-path <PATTERN>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_EXCLUDE_PATH
              <?><?><?><?> <?><?><?>.

       --tag-pattern <PATTERN>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (regex)
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_TAG_PATTERN
              <?><?><?><?> <?><?><?>.

       --with-commit <MSG>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_WITH_COMMIT
              <?><?><?><?> <?><?><?>.

       --with-tag-message [<MSG>]
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> (release)
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_WITH_TAG_MESSAGE
              <?><?><?><?> <?><?><?>.

       --skip-tags <PATTERN>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_SKIP_TAGS <?><?><?><?>
              <?><?><?>.

       --ignore-tags <PATTERN>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_IGNORE_TAGS
              <?><?><?><?> <?><?><?>.

       --count-tags <PATTERN>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_COUNT_TAGS
              <?><?><?><?> <?><?><?>.

       --limit-tags <N>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_LIMIT_TAGS
              <?><?><?><?> <?><?><?>.

       --skip-commit <SHA1>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_SKIP_COMMIT
              <?><?><?><?> <?><?><?>.

       -p, --prepend [<PATH>]
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_PREPEND <?><?><?><?>
              <?><?><?>.

       -o, --output [<PATH>]
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_OUTPUT <?><?><?><?>
              <?><?><?>.

       -t, --tag <TAG>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_TAG <?><?><?><?>
              <?><?><?>.

       --bump [<BUMP>]
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?>

       -b, --body <TEMPLATE>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_TEMPLATE <?><?><?><?>
              <?><?><?>.

       --body-file <PATH>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>

       --from-context <PATH>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?><?> JSON
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_CONTEXT <?><?><?><?>
              <?><?><?>.

       -s, --strip <PART>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>

              <?><?><?><?><?><?> <?><?><?><?>:

                     o header

                     o footer

                     o all

       --sort <SORT> [<?><?><?><?><?><?><?>: oldest]
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>

              <?><?><?><?><?><?> <?><?><?><?>:

                     o oldest

                     o newest

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (REMOTE OPTIONS)
       --github-token <TOKEN>
              <?><?><?><?><?> <?><?><?><?> API <?><?><?><?><?><?><?> (GitHub)
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GITHUB_TOKEN <?><?><?><?>
              <?><?><?>.

       --github-repo <OWNER/REPO>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GITHUB_REPO <?><?><?><?>
              <?><?><?>.

       --gitlab-token <TOKEN>
              <?><?><?><?><?> <?><?><?><?> API <?><?><?><?><?><?> (GitLab)
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GITLAB_TOKEN <?><?><?><?>
              <?><?><?>.

       --gitlab-repo <OWNER/REPO>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GITLAB_REPO <?><?><?><?>
              <?><?><?>.

       --gitea-token <TOKEN>
              <?><?><?><?><?> <?><?><?><?> API <?><?><?><?> (Gitea)
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GITEA_TOKEN <?><?><?><?>
              <?><?><?>.

       --gitea-repo <OWNER/REPO>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GITEA_REPO <?><?><?><?>
              <?><?><?>.

       --bitbucket-token <TOKEN>
              <?><?><?><?><?> <?><?><?><?> API <?><?><?><?><?><?><?><?>
              (Bitbucket)
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> BITBUCKET_TOKEN <?><?><?><?>
              <?><?><?>.

       --bitbucket-repo <OWNER/REPO>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> BITBUCKET_REPO <?><?><?><?>
              <?><?><?>.

       --http-timeout <SECS>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> HTTP <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_HTTP_TIMEOUT
              <?><?><?><?> <?><?><?>.

       --offline
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> GIT_CLIFF_OFFLINE <?><?><?><?>
              <?><?><?>.

<?><?><?><?><?><?><?><?><?><?> (ARGS)
       [RANGE]
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?>

<?><?><?><?> (VERSION)
       v2.14.1

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> git-cliff
       <git-cliff@protonmail.com>

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       git(1)

       <https://git-cliff.org>

                               git-cliff 2.14.1                   git-cliff(1)