Skip to main content

Monorepos

You can generate a changelog scoped to a specific directory by just switching to that directory:

cd packages/some_library
git cliff

To include/exclude specific paths, use the --include-path and --exclude-path arguments:

cd packages/some_library
git cliff --include-path "packages/some_library/**/*" --exclude-path ".github/*"

These paths must be relative to the repository's root and should be a valid glob pattern.

info

Path patterns can be passed in three ways:

# Single pattern
git cliff --include-path "packages/library/**"

# Repeated option
git cliff --include-path "packages/library/**" --include-path "shared/**"

# Quoted, space-delimited patterns
git cliff --include-path "packages/library/** shared/**"

The same forms apply to --exclude-path. Multiple unquoted values after one option are not supported.